Gerar Bicep usando o recurso de composição

O recurso de composição da CLI do Desenvolvedor do Azure (azd) simplifica o processo de criação, implantação e gerenciamento de aplicativos na nuvem. azd composeUsando o , você pode definir e gerenciar a infraestrutura e o código do aplicativo para seu projeto de forma unificada. Este guia explica como gerar código Bicep a partir do azd compose recurso, permitindo que você personalize sua infraestrutura de nuvem para atender às suas necessidades específicas.

Como azd compose gerencia o estado da infraestrutura

O azd compose recurso rastreia na memória o estado da infraestrutura durante o processo de composição. Essa abordagem permite que você defina e refine iterativamente seu aplicativo e infraestrutura sem gerar arquivos imediatamente ou modificar o diretório do projeto.

Quando executa o comando azd infra synth, o estado em memória é convertido em ficheiros Bicep na pasta infra. Neste ponto, o estado da infraestrutura deixa de ser gerenciado na memória para ser representado como código, permitindo uma maior personalização.

Sugestão

Use azd compose para prototipar rapidamente a sua infraestrutura antes de se comprometer com alterações baseadas em arquivos com azd infra synth.

Gerar o código Bicep

Para explorar ou personalizar o código Bicep usado por azd internamente para provisionar os recursos criados pelo azd add, execute o seguinte comando:

azd infra gen

Observação

O azd infra synth comando de versões anteriores do azd agora é um alias de azd infra generate, e continuará a funcionar. No entanto, uma mensagem de aviso será exibida e o comando poderá ser removido em uma versão futura azd .

Este comando gera os arquivos Bicep correspondentes na infra pasta do seu aplicativo.

Gerir atualizações com a Bicep generation

Ao executar o azd infra gen comando, você sai do azd compose fluxo de trabalho e do processo de inicialização simplificado. A partir deste ponto, todas as alterações feitas nos arquivos Bicep gerados não serão mais rastreadas pelo azd compose. Se você modificar os arquivos Bicep e depois executar azd infra gen novamente, suas alterações manuais serão substituídas pelo código recém-gerado.

Veja como um fluxo de trabalho típico pode parecer:

1. Você usa azd add para adicionar novos recursos do Azure ao seu projeto. Esses recursos são gerenciados internamente pela azd.
2. Depois de terminar de adicionar recursos, você executa azd infra gen para gerar arquivos Bicep para esses recursos na pasta do infra projeto. Nesta etapa, os recursos não são mais gerenciados pelo azd compose fluxo de trabalho.
3. Agora você pode atualizar manualmente os arquivos do Bicep à medida que continua desenvolvendo seu aplicativo.
4. Se você adicionar mais recursos ou executar azd infra gen novamente, o infra conteúdo da pasta será regenerado e quaisquer alterações manuais serão perdidas.

Por esse motivo, o recurso de composição é mais adequado para os seguintes cenários:

• Criar um conjunto inicial de recursos do Azure para o seu projeto e, em seguida, gerir atualizações adicionais editando os ficheiros Bicep.
• Gerir os seus recursos do Azure inteiramente através do recurso de composição sem executar azd infra gen.

Próximos passos

Visão geral dos modelos para a CLI do Azure Developer