Explorar os fluxos de trabalho de inicialização da CLI do Desenvolvedor do Azure

A CLI do Desenvolvedor do Azure (azd) fornece um conjunto de comandos para simplificar o desenvolvimento, o provisionamento e a implantação do aplicativo no Azure. O comando azd init ajuda você a configurar projetos novos ou existentes, gerando os arquivos e as configurações necessárias para trabalhar com azd. Este artigo explica os diferentes fluxos de trabalho de inicialização disponíveis e como selecionar a melhor opção para seu cenário de desenvolvimento.

Fluxos de trabalho de inicialização

O azd init comando dá suporte a vários fluxos de trabalho para preparar seu aplicativo para trabalhar com azd:

Examinar o diretório atual: analisa uma base de código de aplicativo existente para gerar arquivos e recursos de configuração apropriados azd .
Selecione um modelo: clona e inicializa um modelo de uma azdgaleria de modelos.
Crie um projeto mínimo: inicializa um arquivo básico azure.yaml como ponto de partida para criar seu próprio azd modelo do zero.

Escolha a abordagem que melhor se ajusta ao seu projeto. Todos esses fluxos são descritos com mais detalhes na visão geral de criação de modelos e artigos relacionados. As seções a seguir fornecem uma visão geral conceitual de cada fluxo.

Examinar o diretório atual

Use esse fluxo de trabalho quando você tiver uma base de código de aplicativo existente e quiser prepará-la para implantação no Azure usando azd.

Navegue até o diretório raiz do projeto.
Executar o comando azd init:
```
azd init
```

Selecione Examinar o diretório atual. azd vai:

Examine seu diretório para determinar o idioma ou a estrutura que seu aplicativo usa.
Selecione uma plataforma de hospedagem apropriada, como Os Aplicativos de Contêiner do Azure.
Solicite que você adicione ou remova os serviços descobertos, se necessário.

? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

Selecione Confirmar e continue inicializando meu aplicativo para concluir o fluxo de trabalho. azd cria o seguinte no diretório do aplicativo:
- Um azure.yaml arquivo que define os serviços de aplicativo e os mapeia para recursos de hospedagem.
- Uma .azure pasta para manter as configurações, como o nome do ambiente.
- Um .gitignore arquivo configurado para o idioma do aplicativo e a plataforma de hospedagem.
Opcionalmente, execute azd up para criar os recursos dos Aplicativos de Contêiner do Azure e implantar seu aplicativo.

Seu aplicativo agora está estruturado como um azd modelo que você pode continuar a desenvolver e expandir com mais recursos e serviços do Azure.

Selecione um modelo

Esse fluxo de trabalho permite que você comece com um modelo predefinido azd que geralmente inclui o código do aplicativo e as definições de infraestrutura necessárias do Azure.

Executar o comando azd init:
```
azd init
```
Observação

Você também pode executar azd init com o --template parâmetro para inicializar diretamente um modelo por nome e ignorar a seleção de fluxo de trabalho.

Escolha Selecionar um modelo. azd exibe uma lista de modelos disponíveis de suas fontes de modelo configuradas.

? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

Digite para filtrar os resultados e buscar pelo Hello AZD template. Pressione Enter para clonar e inicializar o modelo.
Opcionalmente, execute azd up para provisionar e implantar os recursos de modelo no Azure.

Você também pode usar o modelo inicializado como ponto de partida para desenvolvimento adicional.

Criar um projeto mínimo

Para usuários avançados que desejam começar com uma configuração mínima e personalizar tudo manualmente, essa opção fornece apenas a configuração essencial.

Execute o azd init comando com o --minimal sinalizador:
```
azd init --minimal
```
Quando solicitado, insira um nome para o modelo azd e pressione Enter.
```
? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.
```
O --minimal sinalizador cria apenas o seguinte:
- Um arquivo básico azure.yaml com apenas o nome do projeto e schemaVersion
- Um .azure diretório para configuração de ambiente
- Um .gitignore arquivo com entradas apropriadas para a CLI do Desenvolvedor do Azure
Essa inicialização simplificada é ideal quando você:
- Deseja criar sua infraestrutura do zero
- Precisa se integrar azd a um projeto complexo existente
- Planeje usar o azd add comando para criar incrementalmente sua arquitetura
- Preferir controle total sobre sua estrutura de projeto
Após a inicialização, você pode:
- Criar manualmente seus arquivos de infraestrutura em uma infra pasta
- Use a azd addfunção de composição para começar a adicionar recursos do Azure ao seu aplicativo
- Personalizar seu azure.yaml arquivo para definir seus serviços e recursos

Nomenclatura de recursos do Project e do Azure

Quando você inicializa um projeto novo ou existente, o nome do projeto é definido em azure.yaml. O nome do projeto atua como um prefixo para nomes de recursos do Azure criados durante o processo de provisionamento. Ao aderir às regras de validação, você garante que os nomes de recursos gerados do Azure também sejam válidos.

Em modelos Bicep ou Terraform, o nome do projeto geralmente é usado como base para construir nomes de recursos, combinados com o nome do ambiente e outros elementos. Por exemplo:

var resourceToken = '${name}-${environmentName}'

Onde name se refere ao nome do projeto e environmentName é o nome do seu azd ambiente.

Regras de validação de nome do projeto

Ao usar azd init para inicializar um projeto ou ao criar um novo nome de projeto no azure.yaml arquivo, as seguintes regras de validação são aplicadas:

Regra	Description
Caracteres permitidos	Os nomes de projeto podem incluir apenas letras minúsculas, números e hifens.
Caractere inicial	Os nomes do projeto devem começar com uma letra.
Caractere final	Os nomes do projeto não devem terminar com um hífen.
Comprimento	Os nomes do projeto devem ter entre 2 e 63 caracteres.
Sem hifens consecutivos	Os nomes do projeto não podem conter hifens consecutivos.

Essas regras de validação garantem que o nome do projeto seja compatível com os requisitos de nomenclatura dos recursos do Azure e evite falhas de empacotamento de serviço durante a implantação.

Próximas etapas

Depois de inicializar seu projeto com azd init, você pode:

Modifique os arquivos de infraestrutura gerados para personalizar seus recursos do Azure.
Use azd provision para criar os recursos necessários no Azure.
Use azd deploy para implantar o código do aplicativo nos recursos provisionados.
Saiba mais sobre o fluxo de trabalho de inicialização da CLI do Desenvolvedor do Azure para combinar provisionamento e implantação em um único comando.

Comentários

Esta página foi útil?

Last updated on 2025-08-14