Partilhar via

CLI do desenvolvedor do Azure e ambientes de implantação do Azure

  • Artigo

Neste artigo, você aprenderá sobre a CLI do Desenvolvedor do Azure (azd) e como ela funciona com os Ambientes de Implantação do Azure (ADE) para simplificar o processo de provisionamento da infraestrutura de aplicativos e a implantação do código do aplicativo na nova infraestrutura.

azd é uma ferramenta de linha de comando de código aberto que fornece comandos amigáveis para desenvolvedores que mapeiam para os principais estágios do seu fluxo de trabalho. Você pode instalar azd localmente em sua máquina ou usá-lo em outros ambientes.

Com o ADE, você pode criar ambientes a partir de uma definição de ambiente em um catálogo anexado ao seu centro de desenvolvimento ou usando o modelo de extensibilidade do ADE para executar implantações. Ao adicionar azdo , você pode simplificar o processo de provisionamento de infraestrutura e implantação de código na nuvem.

Como funciona com o azd ADE?

azd funciona com o ADE para permitir que você crie ambientes de onde está trabalhando.

Com o ADE e azdo , desenvolvedores individuais que trabalham com infraestrutura e código exclusivos que desejam carregar para a nuvem podem criar um ambiente a partir de uma pasta local. Eles podem usar azd para provisionar um ambiente e implantar seu código perfeitamente.

Em escala, o uso do ADE e azd juntos permite que você forneça uma maneira para os desenvolvedores criarem infraestrutura e código de aplicativos. Sua equipe pode criar vários ambientes ADE a partir da mesma azd definição de ambiente compatível e provisionar código para a nuvem de forma consistente.

Compreender azd os modelos

Os comandos da CLI do Desenvolvedor do Azure são projetados para funcionar com modelos padronizados. Cada modelo é um repositório de código que adere a convenções específicas de arquivos e pastas. Os modelos contêm os ativos azd necessários para provisionar um ambiente de Ambiente de Implantação do Azure. Quando você executa um comando como azd upo , a ferramenta usa os ativos de modelo para executar várias etapas do fluxo de trabalho, como provisionamento ou implantação de recursos no Azure.

O diagrama a seguir mostra uma estrutura de modelo típica:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Todos os azd modelos incluem os seguintes ativos:

  • infra folder - A pasta infra não é usada com azd o ADE. Ele contém toda a infraestrutura Bicep ou Terraform como arquivos de código para o azd modelo. O ADE fornece a infraestrutura como arquivos de código para o azd modelo. Você não precisa incluir esses arquivos em seu azd modelo.

  • azure.yaml file - Um arquivo de configuração que define um ou mais serviços em seu projeto e os mapeia para recursos do Azure para implantação. Por exemplo, você pode definir um serviço de API e um serviço front-end da Web, cada um com atributos que os mapeiam para diferentes recursos do Azure para implantação.

  • Pasta .azure - Contém configurações essenciais do Azure e variáveis de ambiente, como o local para implantar recursos ou outras informações de assinatura.

  • src folder - Contém todo o código-fonte do aplicativo implantável. Alguns azd modelos fornecem apenas ativos de infraestrutura e deixam o diretório src vazio para você adicionar seu próprio código de aplicativo.

A maioria dos azd modelos também inclui opcionalmente uma ou mais das seguintes pastas:

  • Pasta .devcontainer - Permite configurar um ambiente de contêiner de desenvolvimento para seu aplicativo. Esta abordagem de ambiente de desenvolvimento comum que não é específica do azd .

  • Pasta .github - Contém os arquivos de fluxo de trabalho CI/CD para Ações do GitHub, que é o provedor de CI/CD padrão para azd .

  • Pasta .azdo - Se você decidir usar o Azure Pipelines para CI/CD, defina os arquivos de configuração do fluxo de trabalho nesta pasta.

azd catálogos compatíveis

Os catálogos de Ambientes de Implantação do Azure consistem em definições de ambiente: modelos de IAC que definem os recursos de infraestrutura provisionados para um ambiente de implantação. A CLI do Desenvolvedor do Azure usa definições de ambiente no catálogo anexado ao centro de desenvolvimento para provisionar novos ambientes.

A CLI do Desenvolvedor do Azure funciona com modelos ARM armazenados no catálogo do centro de desenvolvimento de Ambientes de Implantação do Azure. Ele também suporta outros modelos IaC, como Bicep e Terraform através do modelo de extensibilidade ADE. Para saber como configurar o modelo de extensibilidade do ADE, consulte Modelo de extensibilidade dos Ambientes de Implantação do Azure.

Para dar suporte adequado a determinados serviços de computação do Azure, a CLI do Desenvolvedor do Azure requer mais definições de configuração no modelo IaC. Por exemplo, você deve marcar os hosts do serviço de aplicativo com informações específicas para que azd saiba como encontrar os hosts e implantar o aplicativo neles.

Pode ver uma lista de serviços do Azure suportados aqui: Serviços de computação do Azure suportados (anfitrião).

Torne seu catálogo ADE compatível com azd

Para habilitar suas equipes de desenvolvimento para nós azd com o ADE, você precisa criar uma definição de ambiente em seu catálogo que seja compatível com azdo . Você pode criar uma nova azddefinição de ambiente compatível ou usar uma definição de ambiente existente no catálogo do centro de desenvolvimento de Ambientes de Implantação do Azure. Se você optar por usar uma definição de ambiente existente, precisará fazer algumas alterações para torná-la compatível com azdo .

As alterações incluem:

  • Se você estiver modificando um modelo existente azd , remova a infra pasta. O ADE usa os seguintes arquivos para criar a infraestrutura:
    • Modelo ARM (azuredeploy.json.)
    • Arquivo de configuração que define parâmetros (environment.yaml ou manifest.yaml)
  • Marque recursos em azure.yaml com informações específicas para que azd saiba como localizar os hosts e implantar o aplicativo neles.

Para saber mais sobre como tornar sua definição de ambiente ADE compatível com azdo , consulte Tornar seu projeto compatível com a CLI do Desenvolvedor do Azure.

Habilitar azd suporte no ADE

Para habilitar azd o suporte com o ADE, você precisa definir o platform.type para devcenter. Essa configuração permite azd usar novos componentes do centro de desenvolvimento para o estado e o provisionamento do ambiente remoto e significa que a pasta infra em seus modelos é ignorada. Em vez disso, azd usa um dos modelos de infraestrutura definidos no catálogo do centro de desenvolvimento para provisionamento de recursos.

Para habilitar azd o suporte, execute o seguinte comando:

 azd config set platform.type devcenter

Explorar azd comandos

Quando o recurso do centro de desenvolvimento está habilitado, o comportamento padrão de alguns comandos comuns azd muda para trabalhar com esses ambientes remotos. Para obter mais informações, consulte Trabalhar com ambientes de implantação do Azure.

Conteúdos relacionados