Utilize a CLI do Azure Developer em clouds soberanas

Este guia explica como configurar o Azure Developer CLI para provisionar recursos e implementar aplicações em diferentes clouds.

O Azure Developer CLI suporta as seguintes clouds:

  • Azure Public (AzureCloud) padrão
  • Azure operado por 21Vianet Cloud (AzureChinaCloud)
  • Azure US Government (AzureUSGovernment)

A nuvem pública Azure é a predefinida e é usada se não for especificada a nuvem.

Authentication

Ao alternar entre clouds, execute azd auth login para autenticar com a cloud definida.

O exemplo seguinte define uma nuvem soberana e executa azd auth login para autenticar com essa nuvem:

azd config set cloud.name AzureUSGovernment
azd auth login

Configurações de cloud

As clouds podem ser configuradas ao nível do utilizador, projeto ou ambiente. A ordem de precedência de configuração é:

  1. A configuração do ambiente é selecionada primeiro
  2. Se não houver cloud configurada no ambiente, a configuração do projeto (azure.yaml) é usada
  3. Se não houver cloud definida na configuração do projeto, a configuração do utilizador (azd config set) é usada
  4. Se não houver cloud definida na configuração do utilizador, o azd usa o público AzureCloud

Configurar nuvens com as definições do utilizador (azd config set)

Defina a nuvem para todas azd as operações usando azd config

azd config set cloud.name AzureCloud
azd config set cloud.name AzureChinaCloud
azd config set cloud.name AzureUSGovernment

Configurar as nuvens no ficheiro azure.yaml do projeto

Use o cloud objeto para definir o nome da nuvem no ficheiro azure.yaml do projeto.

name: project-name
cloud:
  name: AzureCloud
name: project-name
cloud:
  name: AzureChinaCloud
name: project-name
cloud:
  name: AzureUSGovernment

Configurar nuvens no ficheiro config.json de um ambiente

Configure a cloud para ambientes específicos atualizando o ficheiro de configuração do ambiente em .azure/<environment-name>/config.json. Isto permite, por exemplo, a implementação em diferentes nuvens para diferentes ambientes.

{
    "cloud": {
        "name": "AzureCloud"
    }
}
{
    "cloud": {
        "name": "AzureChinaCloud"
    }
}
{
    "cloud": {
        "name": "AzureUSGovernment"
    }
}

Comandos e plataformas suportados

Comandos suportados incluem

  • auth
  • Configurações
  • implementar
  • para baixo
  • env
  • aprovisionar
  • até
  • monitor
  • programa

azd pipeline não é suportado em Sovereign Clouds.

devcenter a plataforma não é suportada no Sovereign Clouds.

Implementação com Terraform

Quando fazes a implementação numa cloud soberana usando azd e Terraform, a az CLI também tem de ser configurada para usar a cloud desejada. Consulte a documentação Autenticação do Terraform usando a CLI do Azure .

Defina a variável ARM_ENVIRONMENT de ambiente para o ambiente desejado. Os valores comuns incluem:

  • public (padrão)
  • usgovernment
  • china

Selecione a nuvem apropriada usando a az CLI:

az cloud set --name AzureCloud
az cloud set --name AzureChinaCloud
az cloud set --name AzureUSGovernment