Visão geral dos ambientes CLI do Azure Developer

A CLI do Desenvolvedor do Azure (azd) permite gerenciar vários ambientes de implantação para seus projetos, para manter as configurações separadas para desenvolvimento, teste e produção. Este artigo explica conceitos essenciais sobre como você pode usar ambientes para gerenciar seu processo de desenvolvimento e implantação.

O que são ambientes?

Um ambiente na CLI do Desenvolvedor do Azure (azd) é um conjunto nomeado de configurações para uma implantação do seu aplicativo, como dev, test ou prod. Diferentes ambientes podem ser configurados com valores diferentes. Os ambientes servem vários propósitos importantes:

• Isolamento: mantenha as implantações de desenvolvimento, teste e produção separadas.
• Gerenciamento de configuração: mantenha configurações diferentes para cada ambiente.
• Colaboração: permita que os membros da equipe trabalhem com seus próprios ambientes.
• Organização de recursos: agrupe e provisione recursos do Azure por ambiente.
• Reprodutibilidade: garanta implantações consistentes em diferentes estágios.

Cada ambiente tem seu próprio grupo de recursos do Azure e definições de configuração. Esse isolamento de ambiente ajuda a evitar que alterações em um ambiente afetem outros.

Estrutura e configuração do ambiente

Os ambientes da CLI do Desenvolvedor do Azure (azd) vivem em uma estrutura de diretórios dentro do seu projeto:

├── .azure                          [Created when you run azd init or azd up]
│   ├── <environment-name-1>        [Directory for environment-specific configurations]
│   │   ├── .env                    [Environment variables for this environment]
│   │   └── config.json             [Additional configuration parameters for this environment]
│   ├── <environment-name-2>        [Another environment]
│   │   ├── .env                    
│   │   └── config.json
│   └── config.json                 [Global azd configuration]

Os principais componentes desta estrutura são:

• .azure directory: O diretório raiz para todas as configurações de ambiente. Excluído do controle do código-fonte .gitignore pelo arquivo por padrão.
• Diretórios específicos do ambiente: diretórios nomeados de acordo com seus ambientes, como dev, test, prod.
• .env file: contém variáveis específicas do ambiente usadas pelo seu aplicativo e durante a implantação.
• config.json: Usado para direcionar configurações que influenciam o azd comportamento e os recursos do comando. Este ficheiro não se destina a ser utilizado diretamente pelos utilizadores finais.

Nomes de ambientes

A nomenclatura do ambiente normalmente segue estes padrões:

• Projetos de equipa: <project-name-[dev/int/prod]>
• Projetos pessoais: <personal-unique-alias-[dev/int/prod]>

Essas convenções de nomenclatura não são impostas e podem ser configuradas pelo azd usuário.

Variáveis de ambiente

As variáveis de Ambiente da CLI do Desenvolvedor do Azure fornecem uma maneira de armazenar definições de configuração que influenciam e podem variar entre ambientes. Quando você executa comandos da CLI do Azure Developer, essas variáveis são usadas para:

• Configure as configurações do seu aplicativo, como pontos de extremidade para serviços do Azure.
• Defina parâmetros de infraestrutura para influenciar o processo de provisionamento.

O .env arquivo contém essas variáveis em um formato padrão:

AZURE_ENV_NAME=dev
AZURE_LOCATION=eastus
AZURE_SUBSCRIPTION_ID=00000000-0000-0000-0000-000000000000
AZURE_RESOURCE_GROUP=rg-dev-12345
SERVICE_WEB_HOSTNAME=web-dev-12345.azurewebsites.net
SERVICE_API_HOSTNAME=api-dev-12345.azurewebsites.net

As variáveis comuns do ambiente incluem:

Ao trabalhar com variáveis de ambiente:

• Evite comprometer .env arquivos com controle do código-fonte. Se a configuração do ambiente precisar ser persistente ou compartilhada, os usuários deverão usar ambientes remotos.
• Use nomenclaturas consistentes em todos os ambientes.
• Use o azd env set comando para atualizar variáveis com segurança.

Comparar outros ambientes de estrutura

Muitas estruturas e ferramentas de programação, como Node.js, Django ou React, usam .env arquivos para configuração. Embora a CLI do Desenvolvedor do Azure (azd) também use .env arquivos, há diferenças importantes:

Embora ambos tenham propósitos semelhantes, a abordagem da CLI do .env Desenvolvedor do Azure adiciona estrutura e ferramentas projetadas para gerenciar vários ambientes de implantação e recursos do Azure.

Próximos passos