Partilhar via

Criar um ambiente usando a CLI do Desenvolvedor do Azure

  • Artigo

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

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

Para saber como configurar o AZD para trabalhar com Ambientes de Implantação do Azure, consulte Usar a CLI do Desenvolvedor do Azure com Ambientes de Implantação do Azure.

Pré-requisitos

Deve:

Prepare-se para trabalhar com o AZD

Quando você trabalha com o AZD pela primeira vez, há algumas tarefas de configuração únicas que você precisa concluir. Essas tarefas incluem instalar a CLI do Desenvolvedor do Azure, entrar em sua conta do Azure e habilitar o suporte a AZD para Ambientes de Implantação do Azure.

Instalar a CLI do Azure Developer

Quando você instala o azd, as ferramentas azd são instaladas dentro do escopo azd em vez de globalmente e são removidas se o azd for desinstalado. Para usar ferramentas azd no Visual Studio Code, instale a extensão.

Para habilitar os recursos da CLI do Desenvolvedor do Azure no Visual Studio Code, instale a extensão CLI do Desenvolvedor do Azure, versão v0.8.3. Selecione o ícone Extensões na barra de atividades, procure CLI do Azure Developer e selecione Instalar.

Captura de tela do Visual Studio Code, mostrando o comando Entrar na paleta de comandos.

Entrar com a CLI do Desenvolvedor do Azure

Aceda aos seus recursos do Azure iniciando sessão. Quando você inicia um logon, uma janela do navegador é aberta e solicita que você faça logon no Azure. Depois de entrar, o terminal exibe uma mensagem informando que você está conectado ao Azure.

Entre no AZD usando a paleta de comandos:

Captura de tela do Visual Studio Code, mostrando o painel Extensões com a CLI do Desenvolvedor do Azure e Instalação realçadas.

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

Captura de tela do terminal azd dev, mostrando pressionar qualquer tecla para fechar a mensagem.

Ativar suporte AZD para 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 e provisionamento do ambiente remoto do AZD usa 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.

Captura de tela do Visual Studio Code, mostrando o comando Enable support na paleta de comandos.

Criar um ambiente a partir do código existente

Agora você está pronto para criar um ambiente para 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 código em uma pasta local.

Inicializar um novo aplicativo

Inicializar 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 tipos de recursos do Azure que o aplicativo usa. Para saber mais sobre azure.yaml, consulte Esquema azure.yaml da CLI do Azure Developer.

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

  2. Abra a paleta de comandos, insira Azure Developer CLI init e selecione Azure Developer CLI (azd): init.

    Captura de ecrã da paleta de comandos do Visual Studio Code com a CLI do Azure Developer (azd): init realçada.

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

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

    Captura de tela do terminal AZD no Visual Studio Code, mostrando o prompt Usar código no diretório atual.

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

    Captura de tela mostrando o prompt de inicialização do AZD para confirmar e continuar, remover um serviço ou adicionar um serviço.

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

    Captura de tela mostrando o prompt azd init para um nome de banco de dados.

  7. Insira um nome para seu ambiente AZD local.

    Captura de tela mostrando o prompt azd init Insira um novo nome de ambiente.

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

    Captura de tela mostrando azd init prompt Select project.

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

    Captura de tela mostrando azd init prompt Selecione definições de ambiente.

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

Provisionar 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.

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

    Captura de tela do Visual Studio Code com azure.yaml realçado e o menu de contexto AZD com a CLI do Desenvolvedor do Azure e o ambiente de Provisionamento realçados.

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

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

  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.

Listar ambientes existentes (opcional)

Verifique se seu ambiente foi criado listando os ambientes existentes.

  1. No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>View Local and Remote Environments (env list).

    Captura de ecrã do Visual Studio Code com azure.yaml realçado e o menu de contexto AZD com a CLI do Azure Developer e a Vista de Ambientes Locais e Remotos realçados.

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

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

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

  1. No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>Deploy Azure Resources (deploy).

    Captura de ecrã do Visual Studio Code com azure.yaml realçado e o menu de contexto AZD com a CLI do Programador do Azure e Implementar no Azure realçados.

  2. Você pode verificar se seu código está implantado selecionando as URLs de ponto final listadas no terminal AZD.

Clean up resources (Limpar recursos)

Quando terminar o seu ambiente, pode eliminar os recursos do Azure.

No Explorer, clique com o botão direito do mouse em azure.yaml e selecione Azure Developer CLI (azd)>Delete Deployment and Resources (down).

Captura de ecrã do Visual Studio Code com azure.yaml realçado e o menu de contexto AZD com a CLI do Programador do Azure e Eliminar Implementação e Recursos (inativo) realçado.

Confirme que deseja excluir o ambiente digitando y quando solicitado.

Conteúdos relacionados