Usar a CLI do Desenvolvedor do Azure em nuvens soberanas

Este guia explica como configurar a CLI do Desenvolvedor do Azure para provisionar recursos e implantar aplicativos em nuvens diferentes.

A CLI do Desenvolvedor do Azure dá suporte às seguintes nuvens:

  • Padrão do Azure Public (AzureCloud)
  • Azure operado pela 21Vianet Cloud (AzureChinaCloud)
  • Azure US Government (AzureUSGovernment)

A nuvem pública do Azure é o padrão e é usada se nenhuma nuvem for especificada.

Autenticação

Ao alternar entre nuvens, execute azd auth login para autenticar com a nuvem definida.

O exemplo a seguir define uma nuvem soberana e é executado azd auth login para autenticar com essa nuvem:

azd config set cloud.name AzureUSGovernment
azd auth login

Configurações de nuvem

As nuvens podem ser configuradas no nível de usuário, projeto ou ambiente. A ordem de precedência de configuração é:

  1. A configuração do ambiente é selecionada primeiro
  2. Se nenhuma nuvem estiver configurada no ambiente, a configuração do projeto (azure.yaml) será usada
  3. Se nenhuma nuvem estiver definida na configuração do projeto, a configuração do usuário (azd config set) será usada
  4. Se nenhuma nuvem estiver definida na configuração do usuário, o azd usará o público AzureCloud

Definir nuvens com configurações de usuário (conjunto de configurações do azd)

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

azd config set cloud.name AzureCloud

azd config set cloud.name AzureChinaCloud

azd config set cloud.name AzureUSGovernment

No arquivo azure.yaml do projeto, configure nuvens

Use o cloud objeto para definir o nome da nuvem no arquivo 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 arquivo de config.json de um ambiente

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

{
    "cloud": {
        "name": "AzureCloud"
    }
}

{
    "cloud": {
        "name": "AzureChinaCloud"
    }
}

{
    "cloud": {
        "name": "AzureUSGovernment"
    }
}

Comandos e plataformas com suporte

Os comandos com suporte incluem

  • auth
  • configuração
  • implantar
  • abaixo
  • env
  • configurar
  • em cima
  • monitor
  • programa

azd pipeline não tem suporte em Nuvens Soberanas.

devcenter não há suporte para a plataforma em Nuvens Soberanas.

Implantação com Terraform

Quando você implanta em uma nuvem soberana usando azd e Terraform, a az CLI também deve ser configurada para usar a nuvem desejada. Consulte a documentação do Terraform sobre a autenticação 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
  • Last updated on