Comece com um novo modelo do Azure Developer CLI (azd)

Você pode usar diferentes métodos de criação para criar os arquivos padrão em um novo modelo da CLI do Desenvolvedor do Azure (azd):

• Use a integração do GitHub Copilot em azd init. O fluxo de trabalho interno analisa arquivos de projeto existentes ou ajuda você a planejar um novo projeto, cria os ativos de modelo e executa a validação de pré-implantação.
• Use outro assistente de codificação de IA. Peça ao assistente para criar o mesmo azure.yaml, a infraestrutura como código, o aplicativo e os arquivos de suporte, sem a integração direta com azd init.
• Crie os arquivos diretamente. Crie e edite os ativos de modelo por conta própria quando quiser ter controle completo ou não usar um assistente de codificação de IA.

Este artigo se concentra principalmente no fluxo de trabalho GitHub Copilot interno, pois fornece uma experiência guiada integrada com azd. Independentemente do método de criação, examine e valide cada arquivo antes da implantação.

Os ativos gerados são arquivos de modelo padrão e editáveis azd . Após a inicialização, você pode atualizá-los diretamente ou com qualquer assistente de codificação de IA.

Pré-requisitos para GitHub Copilot

Para usar o fluxo de trabalho Copilot interno, você precisa:

• Azure Developer CLI 1.23.11 ou posterior.
• Uma assinatura GitHub Copilot ativa.
• Git, que azd init usa para inspecionar a árvore de trabalho antes de modificar arquivos.
• Uma sessão de terminal interativa.

Se você ainda não estiver autenticado com GitHub Copilot, azd solicitará que você entre.

Execute azd version para verificar a versão instalada da CLI do Desenvolvedor do Azure.

Desenvolva com o GitHub Copilot

1. Abra um terminal no diretório em que você deseja criar o modelo.

   Note

   O diretório pode conter um aplicativo existente, um projeto de infraestrutura ou os arquivos iniciais de uma nova solução. Se o diretório contiver alterações não confirmadas, azd peça que você confirme antes de continuar. Confirme ou esconda alterações importantes primeiro.

2. Executar azd init:

   azd init
   

3. Selecione Configurar com o GitHub Copilot (pré-visualização).

   O prompt de inicialização se assemelha ao seguinte exemplo:

   ? How do you want to initialize your app?
      Scan current directory
      Select a template
   > Set up with GitHub Copilot (Preview)
   

4. Examine o acesso à ferramenta solicitada e conceda acesso às ferramentas necessárias para o fluxo de trabalho. Copilot usa azd e Azure recursos de desenvolvimento para inspecionar o projeto, criar arquivos e validar o resultado.

5. Selecione um modelo e um nível de raciocínio se azd solicitar que você os configure.

   Na primeira execução, os prompts usam os rótulos a seguir. As opções de modelo e raciocínio disponíveis dependem de sua conta GitHub Copilot e do modelo selecionado:

   ? Select AI model
   ? Select reasoning effort level
   

6. Descreva o que você deseja criar. Inclua requisitos relevantes, como:

   • Se o modelo inclui código do aplicativo, somente infraestrutura ou ambos.
   • Os idiomas e as estruturas do aplicativo, se conhecidos.
   • Os serviços do Azure e a plataforma de hospedagem a serem usados.
   • Se deve usar Bicep ou Terraform.
   • Requisitos de segurança, rede, dimensionamento e região.

   Por exemplo:

   Build an infrastructure-only azd template that provisions an Azure Container Apps
   environment, Azure Container Registry, and Log Analytics workspace with Bicep.
   Use managed identity and least-privilege role assignments. Parameterize the location
   and environment name so the template can be reused.
   

7. Responda a qualquer pergunta de arquitetura ou configuração de Copilot. O agente prepara o projeto para Azure, gera os ativos de modelo e executa a validação de pré-implantação.

8. Revise a estrutura geral dos arquivos que o Copilot criou ou alterou. Confirme se o modelo inclui a configuração de projeto esperada, o diretório de infraestrutura, a origem do aplicativo e os ativos de suporte para sua solução.

   Por exemplo, um modelo somente de infraestrutura gerado pode conter os seguintes arquivos de chave:

   azure.yaml
   infra/
   ├── main.bicep
   ├── main.parameters.json
   └── modules/
      ├── container-apps-environment.bicep
      └── container-registry.bicep
   

   Para obter diretrizes detalhadas sobre como examinar o conteúdo de configuração e infraestrutura, consulte Explorar e editar arquivos de modelo.

Provisionar e implantar o modelo

Depois de aprovar os arquivos gerados, execute o seguinte comando:

azd up

O comando cria ou seleciona um azd ambiente, provisiona os recursos Azure, empacota todos os serviços de aplicativo e os implanta. Para obter um detalhamento dos comandos, consulte Explore o azd up fluxo de trabalho.

Usar outro método de criação

Outros assistentes de codificação de IA não estão conectados diretamente ao azd init fluxo de trabalho, mas podem criar os mesmos ativos de modelo padrão. Você também pode criar todos os ativos diretamente.

Crie esses ativos por conta própria ou peça a outro assistente de codificação para analisar seus requisitos e criá-los:

• Um azure.yaml arquivo que define o projeto e os serviços implantáveis.
• Bicep ou arquivos Terraform que provisionam os recursos de Azure necessários.
• Saídas de recursos e variáveis de ambiente do aplicativo.
• Dockerfiles, configuração de implantação e scripts de suporte quando necessário.

Para fornecer um ponto de partida mínimo antes de usar outro agente, execute:

azd init --minimal

Se você usar outro assistente de codificação, instrua-o a seguir o esquema azure.yaml, as práticas de segurança da infraestrutura do Azure e as convenções dos modelos descritas em modelos da CLI do Desenvolvedor do Azure. Se você criar os arquivos diretamente, use as mesmas referências do seu guia de implementação. Examine e valide todos os arquivos antes de executar azd up.

Conteúdo relacionado

• Visão geral do desenvolvimento de modelos
• Explorar e editar arquivos de modelo
• Iniciar a partir de um modelo existente
• Estender um modelo
• Explorar o azd init fluxo de trabalho

Solicitar ajuda

Para obter informações sobre como arquivar um bug, solicitar ajuda ou propor um novo recurso para a CLI do Desenvolvedor do Azure, visite a página troubleshooting e suporte.