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

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 aos desenvolvedores que correspondem aos 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 azd, é possível simplificar o processo de provisionamento de infraestrutura e implantação de código na nuvem.

Como é que azd funciona com o ADE?

azd funciona com o ADE para permitir que o utilizador crie ambientes a partir do local onde está a trabalhar.

Com o ADE e azd, programadores individuais a trabalhar com infraestruturas e códigos exclusivos que desejam fazer upload 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 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 necessários azd para poder provisionar um ambiente de Implantação do Azure. Quando se executa um comando como azd up, a ferramenta usa os recursos de modelo para realizar várias etapas do fluxo de trabalho, como o provisionamento ou a 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 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 código para o template azd. 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 comum de ambiente de desenvolvimento não é específica do azd.

  • Pasta .github - Abriga os ficheiros de fluxo de trabalho CI/CD para GitHub Actions, que é o fornecedor padrão de CI/CD 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 permitir que as suas equipas de desenvolvimento utilizem azd com o ADE, precisa de criar uma definição de ambiente no seu catálogo que seja compatível com azd. 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 tiver a opção de usar uma definição de ambiente existente, precisará fazer algumas alterações para torná-la compatível com azd.

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 a definição do seu ambiente ADE compatível com azd, consulte Tornar o seu projeto compatível com o Azure Developer CLI.

Habilitar suporte para azd no ADE

Para habilitar azd o suporte com o ADE, é necessário configurar o platform.type para devcenter. Essa configuração permite azd usar novos componentes do Dev Center para o estado e o provisionamento do ambiente remoto e significa que o diretório infra em seus modelos é ignorado. 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

  • Last updated on