Azure Developer CLI gebruiken in onafhankelijke clouds

In deze handleiding wordt uitgelegd hoe u de Azure Developer CLI configureert voor het inrichten van resources en het implementeren van toepassingen in verschillende clouds.

De Azure Developer CLI ondersteunt de volgende clouds:

  • Azure Public (AzureCloud) standaard
  • Azure beheerd door 21Vianet Cloud (AzureChinaCloud)
  • Azure US Government (AzureUSGovernment)

De openbare Azure-cloud is de standaardcloud en wordt gebruikt als er geen cloud is opgegeven.

Authentication

Wanneer u schakelt tussen clouds, voert u azd auth login uit om te authenticeren met de ingestelde cloud.

In het volgende voorbeeld wordt een onafhankelijke cloud ingesteld en uitgevoerd azd auth login om te verifiëren met die cloud:

azd config set cloud.name AzureUSGovernment
azd auth login

Cloudconfiguraties

Clouds kunnen worden geconfigureerd op gebruikers-, project- of omgevingsniveau. De volgorde van de configuratieprioriteit is:

  1. Omgevingsconfiguratie is eerst geselecteerd
  2. Als er geen cloud is geconfigureerd in de omgeving, wordt de projectconfiguratie (azure.yaml) gebruikt
  3. Als er geen cloud is ingesteld in de projectconfiguratie, wordt de gebruikersconfiguratie (azd config set) gebruikt
  4. Als er geen cloud is ingesteld in de gebruikersconfiguratie, gebruikt azd het openbare AzureCloud

Clouds configureren met gebruikersinstellingen (azd config set)

De cloud instellen voor alle azd bewerkingen met azd config

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

Clouds configureren in het bestand azure.yaml van het project

Gebruik het cloud object om de naam van de cloud in te stellen in het bestand azure.yaml van het project.

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

Clouds configureren in het config.json-bestand van een omgeving

Configureer de cloud voor specifieke omgevingen door het omgevingsconfiguratiebestand bij te werken in .azure/<environment-name>/config.json. Dit maakt bijvoorbeeld implementatie in verschillende clouds mogelijk voor verschillende omgevingen.

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

Ondersteunde opdrachten en platforms

Ondersteunde opdrachten zijn onder meer

  • auth
  • configuratie
  • uitrollen
  • uit
  • Env
  • voorziening
  • omhoog
  • monitoren
  • tonen

azd pipeline wordt niet ondersteund in onafhankelijke clouds.

devcenter platform wordt niet ondersteund in onafhankelijke clouds.

Implementeren met Terraform

Wanneer u implementeert in een onafhankelijke cloud met behulp van azd Terraform, moet de az CLI ook worden geconfigureerd voor het gebruik van de gewenste cloud. Zie de documentatie van Terraform over authenticatie met behulp van de Azure CLI.

Stel de omgevingsvariabele ARM_ENVIRONMENT in op de gewenste omgeving. Veelvoorkomende waarden zijn:

  • public (standaard)
  • usgovernment
  • china

Selecteer de juiste cloud met behulp van de az CLI:

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