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 comandos open-source. Fornece comandos amigáveis para programadores que correspondem às fases-chave do seu fluxo de trabalho. Podes instalar azd localmente no teu computador ou usá-lo noutros 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 executas um comando como azd up, a ferramenta usa os recursos do template para executar vários passos do fluxo de trabalho, como provisionar ou implementar recursos para 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:

  • pasta infra: A pasta infra não é utilizada em azd com 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 código para o template azd. Você não precisa incluir esses arquivos em seu azd modelo.

  • azure.yaml ficheiro: Um ficheiro de configuração que define um ou mais serviços no seu projeto e os mapeia para Azure recursos para implementaçã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.

  • .azure pasta: Contém configurações essenciais do Azure e variáveis de ambiente, como a localização para implementar recursos ou outras informações da subscrição.

  • Pasta src: Contém todo o código-fonte da aplicação deployable. 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:

  • .devcontainer : Permite-lhe configurar um ambiente Dev Container para a sua aplicação. Esta abordagem de ambiente de desenvolvimento comum que não é específica para azd.

  • .github pasta: Guarda os ficheiros de fluxo de trabalho CI/CD para GitHub Actions, que é o fornecedor padrão de CI/CD para azd.

  • .azdo pasta: Se decidir usar Azure Pipelines para CI/CD, defina os ficheiros 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. Também suporta outros modelos IaC, como Bicep e Terraform, através do modelo de extensibilidade ADE. Para aprender a configurar o modelo de extensibilidade ADE, consulte Configurar imagem de contentor para executar implementações.

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.

Para obter uma lista de serviços, consulte 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 ADE, precisa de criar uma definição de ambiente no seu catálogo compatível com azd. Pode criar uma nova definição de ambiente compatível com azd, ou pode usar uma definição de ambiente existente do catálogo do centro de desenvolvimento Azure Deployment Environments. 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. A ADE utiliza os seguintes ficheiros para criar a infraestrutura:

    • Modelo ARM (azuredeploy.json)
    • Ficheiro 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 mais informações, consulte Torne o seu projeto compatível com Azure Developer CLI.

Habilitar suporte para azd no ADE

Para ativar o suporte de azd com o ADE, tem de definir platform.type como devcenter. Esta configuração permite azd utilizar novos componentes do centro de desenvolvimento para o estado remoto do ambiente e provisionamento. Esta configuração significa que a pasta infra nos teus templates é 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

  • Last updated on