Gerar bíceps 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 de nuvem. azd composeUsando, 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 aos seus requisitos específicos.

Como azd compose gerencia o estado da infraestrutura

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

Quando você executa o comando azd infra synth, o estado na memória é convertido em arquivos Bicep na pasta infra. Neste ponto, o estado de infraestrutura faz a transição de ser gerenciado na memória para ser representado como código, permitindo uma personalização adicional.

Dica

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

Gerar o código Bicep

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

azd infra gen

Observação

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

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

Gerenciamento de atualizações com a geração Bicep

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

Veja a aparência de um fluxo de trabalho típico:

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

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

• Criar um conjunto inicial de recursos do Azure para seu projeto e, em seguida, gerenciar outras atualizações por conta própria editando os arquivos Bicep.
• Gerenciando seus recursos do Azure inteiramente por meio do recurso de composição sem executar azd infra gen.

Próximas etapas

Criar uma visão geral dos modelos da CLI do Desenvolvedor do Azure