Criar registro privado para módulos Bicep

Artigo
06/29/2024

Para compartilhar módulos em sua organização, você pode criar um registro de módulo privado. Em seguida, você pode publicar módulos nesse registro e conceder acesso de leitura aos usuários que precisam implantar os módulos. Depois que os módulos são compartilhados nos registros, você pode consultá-los a partir de seus arquivos Bicep. Para usar módulos públicos, consulte Módulos Bicep.

Para trabalhar com registros de módulo, você deve ter a CLI do Bicep versão 0.4.1008 ou posterior. Para usar com a CLI do Azure, você também deve ter a versão 2.31.0 ou posterior; para usar com o Azure PowerShell, você também deve ter a versão 7.0.0 ou posterior.

Recursos de formação

Se você preferir aprender sobre parâmetros por meio de orientação passo a passo, consulte Compartilhar módulos do Bicep usando registros privados.

Configurar registro privado

Um registro Bicep está hospedado no Azure Container Registry (ACR). Use as etapas a seguir para configurar seu registro para módulos.

Se você já tiver um registro de contêiner, poderá usá-lo. Se você precisar criar um registro de contêiner, consulte Guia de início rápido: criar um registro de contêiner usando um arquivo Bicep.

Você pode usar qualquer uma das SKUs de registro disponíveis para o registro do módulo. A replicação geográfica do registro fornece aos usuários uma presença local ou como um hot-backup.
Obtenha o nome do servidor de login. Você precisa desse nome ao vincular ao registro de seus arquivos Bicep. O formato do nome do servidor de login é: <registry-name>.azurecr.io.
- PowerShell
- CLI do Azure
Para obter o nome do servidor de login, use Get-AzContainerRegistry.
```
Get-AzContainerRegistry -ResourceGroupName "<resource-group-name>" -Name "<registry-name>"  | Select-Object LoginServer
```
Para obter o nome do servidor de login, use az acr show.
```
az acr show --resource-group <resource-group-name> --name <registry-name> --query loginServer
```
Para publicar módulos em um registro, você deve ter permissão para enviar uma imagem por push . Para implantar um módulo a partir de um registro, você deve ter permissão para extrair a imagem. Para obter mais informações sobre as funções que concedem acesso adequado, consulte Funções e permissões do Registro de Contêiner do Azure.
Dependendo do tipo de conta que você usa para implantar o módulo, talvez seja necessário personalizar quais credenciais são usadas. Essas credenciais são necessárias para obter os módulos do registro. Por padrão, as credenciais são obtidas da CLI do Azure ou do Azure PowerShell. Você pode personalizar a precedência para obter as credenciais no arquivo bicepconfig.json . Para obter mais informações, consulte Credenciais para restaurar módulos.

Importante

O registro de contêiner privado só está disponível para usuários com o acesso necessário. No entanto, é acessado através da internet pública. Para maior segurança, pode necessitar de acesso através de um ponto de extremidade privado. Consulte Conectar-se de forma privada a um registro de contêiner do Azure usando o Azure Private Link.

O registro de contêiner privado deve ter a política azureADAuthenticationAsArmPolicy definida como enabled. Se azureADAuthenticationAsArmPolicy estiver definido como disabled, você receberá uma mensagem de erro 401 (Não autorizada) ao publicar módulos. Consulte O Registro de Contêiner do Azure apresenta a política de Acesso Condicional.

Publicar ficheiros no registo

Depois de configurar o registro de contêiner, você pode publicar arquivos nele. Use o comando publish e forneça todos os arquivos Bicep que você pretende usar como módulos. Especifique o local de destino para o módulo em seu registro. O comando publish cria um modelo ARM, que é armazenado no registro. Isso significa que, se publicar um arquivo Bicep que faça referência a outros módulos locais, esses módulos serão totalmente expandidos como um arquivo JSON e publicados no registro.

PowerShell
CLI do Azure

Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html

Para executar este comando de implementação, tem de ter a versão mais recente da CLI do Azure.

az bicep publish --file storage.bicep --target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 --documentationUri https://www.contoso.com/exampleregistry.html

Com a CLI do Bicep versão 0.27.1 ou mais recente, você pode publicar um módulo com o código-fonte do Bicep, além do modelo JSON compilado. Se um módulo for publicado com o código-fonte do Bicep em um registro, você poderá pressionar F12 (Ir para Definição) do Visual Studio Code para ver o Código Bicep. A extensão Bicep versão 0.27 ou nova é necessária para ver o arquivo Bicep.

PowerShell
CLI do Azure

Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html -WithSource

Para executar este comando de implementação, tem de ter a versão mais recente da CLI do Azure.

az bicep publish --file storage.bicep --target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 --documentationUri https://www.contoso.com/exampleregistry.html --with-source

Com a opção com origem, você vê outra camada no manifesto:

Se o módulo Bicep fizer referência a um módulo em um Registro Privado, o ponto de extremidade ACR estará visível. Para ocultar o ponto de extremidade completo, você pode configurar um alias para o registro privado.

Ver ficheiros no registo

Para ver o módulo publicado no portal:

Inicie sessão no portal do Azure.
Pesquise registros de contêineres.
Selecione o seu registo.
Selecione Serviços ->Repositórios no menu à esquerda.
Selecione o caminho do módulo (repositório). No exemplo anterior, o nome do caminho do módulo é bíceps/modules/storage.
Selecione a etiqueta. No exemplo anterior, a tag é v1.
A referência Artefato corresponde à referência usada no arquivo Bicep.

Agora você está pronto para fazer referência ao arquivo no registro a partir de um arquivo Bicep. Para obter exemplos da sintaxe a ser usada para fazer referência a um módulo externo, consulte Módulos Bicep.

Trabalhando com arquivos de registro Bicep

Ao usar arquivos bicep hospedados em um registro remoto, é importante entender como sua máquina local interage com o registro. Quando você declara pela primeira vez a referência ao Registro, seu editor local tenta se comunicar com o Registro de Contêiner do Azure e baixar uma cópia do Registro para seu cache local.

O cache local é encontrado em:

No Windows

%USERPROFILE%\.bicep\br\<registry-name>.azurecr.io\<module-path\<tag>

No Linux
```
/home/<username>/.bicep
```
No Mac
```
~/.bicep
```

Sua máquina local pode reconhecer quaisquer alterações feitas no registro remoto até que você execute um restore com o arquivo especificado que inclui a referência do registro.

az bicep restore --file <bicep-file> [--force]

Para obter mais informações, consulte o restore comando.

Próximos passos

Para saber mais sobre módulos, consulte Módulos do bíceps.
Para configurar aliases para um registro de módulo, consulte Adicionar configurações de módulo no arquivo de configuração do Bicep.
Para obter mais informações sobre como publicar e restaurar módulos, consulte Comandos da CLI do Bicep.

Partilhar via