Explore os fluxos de trabalho de inicialização da CLI do Azure Developer

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 azd init comando ajuda você a configurar projetos novos ou existentes, gerando os arquivos e as configurações necessárias para trabalhar com azdo . 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 suporta vários fluxos de trabalho para preparar seu aplicativo para trabalhar com azd:

Verificar diretório atual: analisa uma base de código de aplicativo existente para gerar arquivos de configuração e recursos apropriados azd .
Selecione um modelo: clona e inicializa um modelo de uma azdgaleria de modelos.
Criar 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 adapta ao seu projeto. Todos esses fluxos são descritos com mais detalhes na visão geral Criar modelos e artigos relacionados. As seções a seguir fornecem uma visão geral conceitual de cada fluxo.

Verificar diretório atual

Utilize este fluxo de trabalho se 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 seu projeto.
Execute o azd init comando:
```
azd init
```

Selecione Verificar diretório atual. azd irá:

Analise seu diretório para determinar o idioma ou a estrutura que seu aplicativo usa.
Selecione uma plataforma de hospedagem apropriada, como Aplicativos de Contêiner do Azure.
Solicitar que você adicione ou remova 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 do seu aplicativo e os mapeia para recursos de hospedagem.
- Uma .azure pasta para armazenar definições de configuração, 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 pré-criado azd que geralmente inclui o código do aplicativo e as definições de infraestrutura do Azure necessárias.

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

Você também pode executar azd init com o --template parâmetro para inicializar diretamente um modelo pelo nome e ignorar a seleção do 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 procurar o Hello AZD modelo. 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 posterior.

Criar um projeto mínimo

Para usuários avançados que desejam começar com uma configuração mínima e personalizar tudo manualmente, esta 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:
- Quer construir a sua infraestrutura a partir do zero
- Necessidade de integração azd com um projeto complexo existente
- Planeje usar o azd add comando para criar incrementalmente sua arquitetura
- Prefira o controle total sobre a estrutura do seu projeto
Após a inicialização, você pode:
- Crie manualmente seus arquivos de infraestrutura em uma infra pasta
- Use o azd addrecurso de composição para começar a adicionar recursos do Azure ao seu aplicativo
- Personalize 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 serão válidos.

Em modelos Bicep ou Terraform, o nome do projeto é frequentemente usado como base para construir nomes de recursos, combinado 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 do nome do projeto

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

Regra	Description
Caracteres permitidos	Os nomes dos projetos podem incluir apenas letras minúsculas, números e hífenes.
Personagem inicial	Os nomes dos projetos devem começar com uma letra.
Personagem final	Os nomes dos projetos não devem terminar com um hífen.
Comprimento	Os nomes dos projetos devem ter entre 2 e 63 caracteres.
Sem hífenes consecutivos	Os nomes dos projetos não podem conter hífenes 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 evitam falhas de empacotamento de serviço durante a implantação.

Próximos passos

Depois de inicializar o 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 uma só linha de comando.

Comentários

Esta página foi útil?

Last updated on 2025-08-15