Comece com um novo modelo Azure Developer CLI (azd)

Pode usar diferentes métodos de autoria para construir os ficheiros padrão num novo modelo Azure Developer CLI (azd):

Utilize a integração do GitHub Copilot em azd init. O fluxo de trabalho incorporado analisa ficheiros de projeto existentes ou ajuda-o a planear um novo projeto, cria os ativos do modelo e executa a validação pré-implementação.
Usa outro assistente de programação por IA. Peça ao assistente para criar os mesmos azure.yaml, infraestrutura como código, aplicação e ficheiros de suporte, sem integrar diretamente com azd init.
Criar os ficheiros diretamente. Cria e edita os recursos do modelo tu próprio quando quiseres controlo total ou não usares um assistente de programação por IA.

Este artigo foca-se principalmente no fluxo de trabalho integrado do GitHub Copilot porque proporciona uma experiência guiada integrada com azd. Independentemente do método de autoria, revê e valida cada ficheiro antes da implementação.

Importante

A integração do GitHub Copilot em azd init está em pré-visualização. As funcionalidades de pré-visualização podem mudar antes da disponibilidade geral. Para mais informações, consulte a azd estratégia de versões e lançamento de funcionalidades.

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

Pré-requisitos para o GitHub Copilot

Para usar o fluxo de trabalho Copilot incorporado, precisa de:

Azure Developer CLI 1.23.11 ou posterior.
Uma subscrição ativa do GitHub Copilot.
Git, que o azd init utiliza para inspecionar a árvore de trabalho antes de modificar ficheiros.
Uma sessão interativa de terminal.

Se ainda não estiveres autenticado no GitHub Copilot, azd pede-te para iniciares sessão.

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

Note

O azd init fluxo de trabalho inicia uma sessão dedicada de agente do Copilot no GitHub no terminal. Não utiliza nem continua uma sessão ativa do GitHub Copilot Chat no Visual Studio Code.

Criar com o GitHub Copilot

Abre um terminal no diretório onde queres construir o modelo.

Note

O diretório pode conter uma aplicação existente, um projeto de infraestrutura ou os ficheiros iniciais de uma nova solução. Se o diretório contiver alterações não comprometidas, azd pede-lhe para confirmar antes de continuar. Compromete-se ou esconda as mudanças importantes primeiro.
Executar azd init:
```
azd init
```

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

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

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

Revise o acesso às ferramentas solicitadas e conceda acesso às ferramentas necessárias para o fluxo de trabalho. O Copilot utiliza azd capacidades de desenvolvimento do Azure para inspecionar o projeto, criar ficheiros e validar o resultado.
Selecione um modelo e um nível de raciocínio se azd lhe pedir para configurá-los.

Na primeira execução, as mensagens usam os seguintes rótulos. As opções disponíveis de modelo e raciocínio dependem da sua conta no GitHub Copilot e do modelo selecionado:
```
? Select AI model
? Select reasoning effort level
```
Descreve o que queres construir. Incluir requisitos relevantes tais como:
- Quer o modelo inclua código de aplicação, apenas infraestrutura, ou ambos.
- As linguagens e frameworks de aplicação, se conhecidos.
- Os serviços do Azure e a plataforma de alojamento para usar.
- Se devo usar Bicep ou Terraform.
- Requisitos de segurança, redes, escalabilidade 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.
```
Responda a quaisquer perguntas de arquitetura ou configuração do Copilot. O agente prepara o projeto para o Azure, gera os ativos do template e executa a validação pré-implementação.
Revise a estrutura geral dos ficheiros que o Copilot criou ou alterou. Confirme que o modelo inclui a configuração esperada do projeto, diretório de infraestrutura, código-fonte da aplicação e recursos de suporte para a sua solução.

Por exemplo, um template gerado apenas para infraestrutura pode conter os seguintes ficheiros-chave:
```
azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep
```
Para orientações detalhadas sobre a revisão da configuração e do conteúdo da infraestrutura, consulte Explorar e editar ficheiros modelo.

Provisionar e implementar o modelo

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

azd up

O comando cria ou seleciona um azd ambiente, provisiona os recursos do Azure, empacota quaisquer serviços de aplicação e implementa-os. Para uma análise detalhada dos comandos, consulte Explorar o azd up fluxo de trabalho.

Use outro método de autoria

Outros assistentes de programação com IA não estão ligados diretamente ao fluxo de trabalho azd init, mas podem criar os mesmos recursos de modelo padrão. Também podes criar todos os assets diretamente.

Crie estes assets você mesmo, ou peça a outro assistente de programação para analisar os seus requisitos e criá-los:

Um azure.yaml ficheiro que define o projeto e os serviços implementáveis.
Ficheiros Bicep ou Terraform que aprovisionam os recursos do Azure necessários.
Saídas de recursos e variáveis do ambiente da aplicação.
Dockerfiles, configuração de implementaçã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 usares outro assistente de programação, instrui-o a seguir o azure.yaml esquema, as práticas de segurança da infraestrutura do Azure e as convenções de templates descritos nos templates de CLI do Azure Developer. Se criares os ficheiros diretamente, usa as mesmas referências do teu guia de implementação. Revise e valide todos os ficheiros antes de executar azd up.

Pedir ajuda

Para informações sobre como registar um bug, pedir ajuda ou propor uma nova funcionalidade para a Azure Developer CLI, por favor visite a página troubleshooting and support.

Comentários

Esta página foi útil?

Last updated on 2026-09-16