Suporte da CLI do Desenvolvedor do Azure para Ambientes de Implantação do Azure

Artigo
12/21/2024

A CLI do Desenvolvedor do Azure (azd) fornece suporte para Ambientes de Implantação do Azure. Um Ambiente de Implantação do Azure (ADE) é uma coleção pré-configurada de recursos do Azure implantados em assinaturas predefinidas. A governança do Azure é aplicada a essas assinaturas com base no tipo de ambiente, como área restrita, teste, preparo ou produção. Com os Ambientes de Implantação do Azure, você pode aplicar políticas de segurança corporativa e fornecer um conjunto selecionado de modelos predefinidos de infraestrutura como código (IaC).

Pré-requisitos

Verifique se você concluiu os seguintes pré-requisitos para trabalhar com Ambientes de Implantação do Azure usando azd:

Instalado azd localmente ou ter acesso a azd via Cloud Shell
Criou e configurou um Ambiente de Implantação do Azure com um centro de desenvolvimento, projeto e catálogo de modelos
Tipos de ambiente configurados no nível do centro de desenvolvimento e do projeto
Verifique se o desenvolvedor tem a função de Usuário de Ambientes de Implantação no projeto

Dica

Compreender os principais conceitos sobre os Ambientes de Implantação do Azure é essencial para trabalhar com eles via azd.

Habilitar o suporte ao Ambiente de Implantação do Azure

Você pode configurar azd para provisionar e implantar recursos em seus ambientes de implantação usando comandos padrão, como azd up ou azd provision. Para habilitar o suporte para Ambientes de Implantação do Azure, execute o seguinte comando:

azd config set platform.type devcenter

Quando platform.type estiver definido como devcenter, todo azd estado e provisionamento do ambiente remoto aproveitará os novos componentes do centro de desenvolvimento. Essa configuração também significa que a pasta infra em seus modelos locais será efetivamente ignorada. Em vez disso, azd usará um dos modelos de infraestrutura definidos no catálogo do centro de desenvolvimento para provisionamento de recursos.

Você também pode desativar o suporte do centro de desenvolvimento através do seguinte comando:

azd config unset platform

Trabalhar com ambientes de implantação do Azure

Quando o recurso do centro de desenvolvimento está habilitado, o comportamento padrão de alguns comandos comuns do azd muda para trabalhar com esses ambientes remotos. O recurso do centro de desenvolvimento expande a funcionalidade fornecida pelo suporte de ambiente padrão azdremoto.

AZD Init

A experiência de comando azd init no modo centro de desenvolvimento mostra todos os modelos ADE compatíveis com azd para seleção do seu catálogo configurado. Durante o processo de inicialização, depois que azd clona o código do modelo, o arquivo de azure.yaml será atualizado automaticamente para incluir uma seção de platform com a configuração selecionada com base no modelo escolhido. A configuração inclui o nome do centro de desenvolvimento, o catálogo e a definição do ambiente.

azd init

azd up

O comando azd up empacotará, provisionará e implantará seu aplicativo nos Ambientes de Implantação do Azure. No entanto, o estágio de provisionamento do comando azd up usará os modelos de infraestrutura como código selecionados em seu centro de desenvolvimento remoto, enquanto o estágio de implantação implantará o código-fonte em seu modelo de azd. Enquanto o modo de centro de desenvolvimento estiver habilitado, azd ignorará a pasta infra em seu modelo de azd local e provisionará recursos apenas usando os modelos do centro de desenvolvimento. O comando também solicitará quaisquer valores necessários, como o projeto ou o tipo de ambiente do Ambiente de Implantação do Azure.

azd up

Lista de modelos AZD

O comando azd template list exibirá os modelos de infraestrutura disponíveis no catálogo do centro de desenvolvimento, em vez de mostrar modelos da galeria padrão do AZD Awesome. Catálogos fornecem um conjunto de modelos de infraestrutura como código selecionados e aprovados que suas equipes de desenvolvimento podem usar para criar ambientes.

azd template list

Uma captura de tela mostrando a galeria de modelos atualizada.

Disposição AZD

O comando azd provision criará novos ambientes de centro de desenvolvimento. O comando solicitará quaisquer valores ausentes, como o tipo de ambiente ou projeto. Quando o comando for executado, ele usará o modelo de infraestrutura associado para provisionar o conjunto correto de recursos do Azure para esse ambiente. Enquanto o modo de centro de desenvolvimento estiver habilitado, azd ignorará a pasta infra em seu modelo de azd local e provisionará recursos apenas usando os modelos do centro de desenvolvimento.

azd provision

Lista AZD ENV

O comando azd env list exibirá a mesma lista de ambientes que você veria no portal do desenvolvedor.

azd env list

Marcando recursos para ambientes de implantação do Azure

azd provisionamento para Ambientes de Implantação do Azure depende de modelos selecionados do catálogo do centro de desenvolvimento. Os modelos no catálogo podem ou não atribuir marcas a recursos provisionados do Azure aos quais você associe seus serviços de aplicativo no arquivo azure.yaml. Se os modelos não atribuírem tags, você poderá resolver esse problema de duas maneiras:

Trabalhe com o administrador do catálogo do centro de desenvolvimento para garantir que os recursos provisionados do Azure incluam tags para associá-los aos serviços definidos em seu arquivo azure.yaml.

Especifique o resourceName em seu arquivo de azure.yaml em vez de usar tags:

services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Definir configurações do centro de desenvolvimento

Você pode definir azd configurações para seus centros de desenvolvimento em vários locais. As configurações são combinadas desses locais para criar o conjunto final de configurações na seguinte ordem de precedência:

Variáveis de ambiente
Configuração do ambiente Azd
Configuração do projeto
Configuração do usuário

azd solicitará automaticamente quaisquer valores de configuração que estejam faltando nessas fontes. Cada uma dessas opções de configuração é detalhada nas seções a seguir.

Variáveis de ambiente

As seguintes variáveis de ambiente serão descobertas e usadas por azd:

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Definir configurações

Defina configurações para seus centros de desenvolvimento no escopo do ambiente de azd em .azure/<env>/config.json arquivo:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Âmbito do projeto

Defina configurações para seus centros de desenvolvimento no escopo do projeto azd no nó platform do arquivo azure.yaml:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Âmbito do utilizador

Defina configurações para seus centros de desenvolvimento no escopo do usuário no arquivo ~/<user_profile>/.azd/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Partilhar via