Criar um ambiente usando o Azure Developer CLI.

Neste artigo, você instala o o Azure Developer CLI (AZD), cria um novo ambiente de implantação provisionando sua infraestrutura de aplicativo nos Ambientes de Implantação do Azure e implanta o código do aplicativo no ambiente de implantação provisionado.

O o Azure Developer CLI (AZD) é uma ferramenta de software livre que acelera o tempo necessário para que você obtenha seu aplicativo do ambiente de desenvolvimento local para o Azure. A AZD fornece práticas recomendadas, comandos amigáveis ao desenvolvedor que mapeiam os principais estágios do seu fluxo de trabalho, esteja você trabalhando no terminal, no editor ou no ambiente de desenvolvimento integrado (IDE) ou CI/CD (integração contínua/implantação contínua).

Para saber como configurar o AZD para funcionar com Ambientes de Implantação do Azure, veja Usar Azure Developer CLI com Ambientes de Implantação do Azure.

Pré-requisitos

Você deve:

• Familiarize-se com os Ambientes de Implantação do Azure. Examine O que são os Ambientes de Implantação do Azure? e os Principais conceitos para Ambientes de Implantação do Azure.
• Crie e configure um centro de desenvolvimento com um projeto, tipos de ambiente e um catálogo. Use o seguinte artigo como orientação:
  • Início Rápido: Criar e configurar um centro de desenvolvimento para os Ambientes de Implantação Azure.
• Um catálogo anexado ao centro de desenvolvimento.

Preparar-se para trabalhar com o AZD

Quando você trabalha com o AZD pela primeira vez, há algumas tarefas de instalação única que você precisa concluir. Essas tarefas incluem instalar a Azure Developer CLI, entrar em sua conta do Azure e habilitar o suporte do AZD para ambientes de implantação do Azure.

Instalar a extensão da Azure Developer CLI para Visual Studio Code

Quando você instala o azd, as ferramentas do azd são instaladas no escopo do azd em vez de globalmente e são removidas caso o azd seja desinstalado. Você pode instalar o azd no Visual Studio Code ou na linha de comando.

Visual Studio Code

Para habilitar os recursos da Azure Developer CLI no Visual Studio Code, instale a extensão da Azure Developer CLI, versão v0.8.0-alpha.1-beta.3173884. Selecione o ícone Extensões na barra de Atividades , pesquise a Azure Developer CLI e selecione Instalar.

CLI do Desenvolvedor do Azure

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Visual Studio

No Visual Studio 2022 17.3 Versão Prévia 2 ou posterior, você pode habilitar a integração com o azd como uma versão prévia do recurso.

Para habilitar o recurso azd, acesse Ferramentas>Opções>Ambiente>Versão Prévia dos Recursos e selecione Integração com o azd, o Azure Developer CLI.

Quando o recurso estiver habilitado, você poderá usar o Azure Developer CLI no terminal de sua escolha no Windows, Linux ou macOS.

Entrar com a Azure Developer CLI

Para acessar seus recursos do Azure, faça logon. Quando você inicia um logon, uma janela do navegador é aberta e solicita que você faça logon no Azure. Depois de entrar, o terminal exibirá uma mensagem informando que você está conectado ao Azure.

Entre no AZD usando a paleta de comandos:

Visual Studio Code

A saída dos comandos emitidos da paleta de comandos é exibida em um terminal de desenvolvimento azd, como o exemplo a seguir:

CLI do Desenvolvedor do Azure

Entre no Azure na CLI usando o seguinte comando:

 azd auth login

Visual Studio

Para acessar seus recursos do Azure, faça logon. Quando você inicia um logon, uma janela do navegador é aberta e solicita que você faça logon no Azure. Depois de entrar, o terminal exibirá uma mensagem informando que você está conectado ao Azure.

Para abrir o Prompt de comando do Desenvolvedor:

1. No menu Ferramentas, selecione Terminal.

2. Na janela Terminal, selecione Prompt de Comando do Desenvolvedor.

   

Entre no AZD usando o Terminal de Comando do Desenvolvedor:

 azd auth login

Habilitar o suporte do AZD para o ADE

Você pode configurar o AZD para provisionar e implantar recursos em seus ambientes de implantação usando comandos padrão, como azd up ou azd provision. Quando platform.type é definido como devcenter, todo o estado do ambiente remoto do AZD e o provisionamento usam componentes do centro de desenvolvimento. O AZD usa um dos modelos de infraestrutura definidos no catálogo do centro de desenvolvimento para provisionamento de recursos. Nessa configuração, a pasta infra em seus modelos locais não é usada.

Visual Studio Code

CLI do Desenvolvedor do Azure

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

Criar um ambiente com base no código existente

Agora você está pronto para criar um ambiente no qual trabalhar. Você pode começar com o código em uma pasta local ou clonar um repositório existente. Neste exemplo, você cria um ambiente usando o código em uma pasta local.

Inicializar um novo aplicativo

A inicialização de um novo aplicativo cria os arquivos e pastas necessários para que o AZD funcione com seu aplicativo.

O AZD usa um arquivo azure.yaml para definir o ambiente. O arquivo azure.yaml define e descreve os aplicativos e os tipos de recursos do Azure que o aplicativo usa. Para saber mais sobre azure.yaml, consulte o esquema azure.yaml da Azure Developer CLI.

Visual Studio Code

1. No Visual Studio Code, abra a pasta que contém o código do seu aplicativo.

2. Abra a paleta de comandos e insira a inicialização da Azure Developer CLI e, na lista, selecione Azure Developer CLI (azd): init.

   

3. Na lista de modelos, para continuar sem selecionar um modelo, pressione ENTER duas vezes.

4. No terminal do AZD, selecione Usar código no diretório atual.

   

5. azd init identifica os serviços definidos no código do aplicativo e solicita que você confirme, continue e remova ou adicione um serviço. Selecione Confirmar e continuar inicializando meu aplicativo.

   

6. azd init continua coletando informações para configurar seu aplicativo. Para este aplicativo de exemplo, você será solicitado a usar o nome da instância do banco de dados do MongoDB e as portas em que os serviços escutam.

   

7. Insira um nome para seu ambiente AZD local.

   

8. azd init exibe uma lista dos projetos aos quais você tem acesso. Selecionar o projeto para seu ambiente

   

9. azd init exibe uma lista de definições de ambiente no projeto. Selecione uma definição de ambiente.

   

   O AZD cria os recursos do projeto, incluindo um arquivo azure.yaml na raiz do projeto.

CLI do Desenvolvedor do Azure

1. Na CLI, navegue até a pasta que contém o código do aplicativo.

2. Execute o seguinte comando para inicializar o aplicativo e fornecer informações quando solicitado:

   azd init
   

3. No terminal do AZD, selecione Usar código no diretório atual.

   

   O AZD examina o diretório atual e coleta mais informações dependendo do tipo de aplicativo que você está criando. Siga os prompts para configurar seu ambiente do AZD.

4. azd init identifica os serviços definidos no código do aplicativo e solicita que você confirme, continue e remova ou adicione um serviço. Selecione Confirmar e continuar inicializando meu aplicativo.

   

5. azd init continua coletando informações para configurar seu aplicativo. Para este aplicativo de exemplo, você será solicitado a usar o nome da instância do banco de dados do MongoDB e as portas em que os serviços escutam.

   

6. Insira um nome para seu ambiente AZD local.

   

7. azd init exibe uma lista dos projetos aos quais você tem acesso. Selecione o projeto para seu ambiente.

   

8. azd init exibe uma lista de definições de ambiente no projeto. Selecione uma definição de ambiente.

   

   O AZD cria os recursos do projeto, incluindo um arquivo azure.yaml na raiz do projeto.

Visual Studio

1. Na CLI, navegue até a pasta que contém o código do aplicativo.

2. Execute o seguinte comando para inicializar o aplicativo e fornecer informações quando solicitado:

   azd init
   

3. No terminal do AZD, selecione Usar código no diretório atual.

   

   O AZD examina o diretório atual e coleta mais informações dependendo do tipo de aplicativo que você está criando. Siga os prompts para configurar seu ambiente do AZD.

4. azd init identifica os serviços definidos no código do aplicativo e solicita que você confirme, continue e remova ou adicione um serviço. Selecione Confirmar e continuar inicializando meu aplicativo.

   

5. azd init continua coletando informações para configurar seu aplicativo. Para este aplicativo de exemplo, você será solicitado a usar o nome da instância do banco de dados do MongoDB e as portas em que os serviços escutam.

   

6. Insira um nome para seu ambiente AZD local.

   

7. azd init exibe uma lista dos projetos aos quais você tem acesso. Selecione o projeto para seu ambiente.

   

8. azd init exibe uma lista de definições de ambiente no projeto. Selecione uma definição de ambiente.

   O AZD cria os recursos do projeto, incluindo um arquivo azure.yaml na raiz do projeto.

Provisionar a infraestrutura para o Ambiente de Implantação do Azure

Quando estiver pronto, você poderá provisionar seu ambiente local para um ambiente remoto de Ambientes de Implantação do Azure no Azure. Esse processo provisiona a infraestrutura e os recursos definidos na definição de ambiente no catálogo do centro de desenvolvimento.

Visual Studio Code

1. No Explorer, clique com o botão direito do mouse em azure.yaml e selecione a Azure Developer CLI (azd)>Provisionar Recursos do Azure (provisionamento).

   

2. O AZD verifica os Ambientes de Implantação do Azure em busca de projetos aos quais você tem acesso. No terminal do AZD, selecione ou insira as seguintes informações:

   1. Project
   2. Definição do ambiente
   3. Tipo de ambiente
   4. Localidade

3. O AZD instrui o ADE a criar um novo ambiente com base nas informações fornecidas na etapa anterior.

4. Você pode exibir os recursos criados no portal do Azure ou no portal do desenvolvedor.

CLI do Desenvolvedor do Azure

Provisione o aplicativo no Azure usando o seguinte comando:

azd provision

1. 'azd provision' fornece uma lista de projetos aos quais você tem acesso. Selecione o projeto no qual você deseja provisionar seu aplicativo.

   

2. 'azd provision' fornece uma lista de definições de ambiente no projeto selecionado. Selecione a definição do ambiente que deseja usar para provisionar o aplicativo.

   

3. 'azd provision' fornece uma lista de tipos de ambiente no projeto selecionado. Selecione o tipo de ambiente que deseja usar para provisionar o aplicativo.

   

4. O AZD instrui o ADE a criar um novo ambiente com base nas informações fornecidas na etapa anterior.

   

5. Você pode exibir os recursos criados no portal do Azure ou no portal do desenvolvedor.

Visual Studio

Provisione o aplicativo no Azure usando o seguinte comando:

azd provision

1. 'azd provision' fornece uma lista de projetos aos quais você tem acesso. Selecione o projeto no qual você deseja provisionar seu aplicativo.

   

2. 'azd provision' fornece uma lista de definições de ambiente no projeto selecionado. Selecione a definição do ambiente que deseja usar para provisionar o aplicativo.

   

3. 'azd provision' fornece uma lista de tipos de ambiente no projeto selecionado. Selecione o tipo de ambiente que deseja usar para provisionar o aplicativo.

4. O AZD instrui o ADE a criar um novo ambiente com base nas informações fornecidas na etapa anterior.

5. Você pode exibir os recursos criados no portal do Azure ou no portal do desenvolvedor.

Listar ambientes existentes (opcional)

Verifique se o ambiente foi criado listando os ambientes existentes.

Visual Studio Code

1. No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>Exibir Ambientes Locais e Remotos (lista env).

   

   Você será solicitado a selecionar um projeto e uma definição de ambiente.

CLI do Desenvolvedor do Azure

Use o seguinte comando para exibir os ambientes aos quais você tem acesso: o ambiente local do AZD e o ambiente remoto de Ambientes de Implantação do Azure.

azd env list

azd env list solicita que você selecione um projeto e uma definição de ambiente.

Visual Studio

Use o seguinte comando para exibir os ambientes aos quais você tem acesso: o ambiente local do AZD e o ambiente remoto de Ambientes de Implantação do Azure.

azd env list

azd env list solicita que você selecione um projeto e uma definição de ambiente.

Implantar código em ambientes de implantação do Azure

Quando o ambiente é provisionado, você pode implantar seu código no ambiente.

Visual Studio Code

1. No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>Implantar os Recursos do Azure (implantar).

   

2. Você pode verificar se o código foi implantado selecionando as URLs de ponto de extremidade listadas no terminal do AZD.

CLI do Desenvolvedor do Azure

Implante o código do aplicativo no ambiente remoto dos Ambientes de Implantação do Azure que você provisionou usando o seguinte comando:

azd deploy

A implantação do seu código no ambiente remoto pode levar vários minutos.

Você pode exibir o progresso da implantação no portal do Azure:

Quando a implantação for concluída, você poderá visualizar os recursos que foram provisionados no portal do Azure:

Você pode verificar se o código foi implantado selecionando as URLs de ponto de extremidade listadas no terminal do AZD.

Para este aplicativo de exemplo, você verá algo semelhante a:

Visual Studio

Implante o código do aplicativo no ambiente remoto dos Ambientes de Implantação do Azure que você provisionou usando o seguinte comando:

azd deploy

A implantação do seu código no ambiente remoto pode levar vários minutos.

Você pode exibir o progresso da implantação no portal do Azure:

Quando a implantação for concluída, você poderá visualizar os recursos que foram provisionados no portal do Azure:

Você pode verificar se o código foi implantado selecionando as URLs de ponto de extremidade listadas no terminal do AZD.

Limpar os recursos

Quando terminar de usar seu ambiente, você poderá excluir os recursos do Azure.

Visual Studio Code

No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>Excluir Implantação e Recursos (reduzir).

Confirme se você deseja excluir o ambiente inserindo y quando solicitado.

CLI do Desenvolvedor do Azure

Exclua os recursos do Azure usando o seguinte comando:

azd down --environment <environmentName>

Visual Studio

Exclua os recursos do Azure usando o seguinte comando:

azd down --environment <environmentName>

Conteúdo relacionado

• Criar e configurar um centro de desenvolvimento
• O que é o Azure Developer CLI?
• Instalar ou atualizar a Azure Developer CLI