Verwenden der Azure Developer CLI in souveränen Clouds

In diesem Handbuch wird erläutert, wie Sie die Azure Developer CLI so konfigurieren, dass Ressourcen bereitgestellt und Anwendungen in verschiedenen Clouds bereitgestellt werden.

Die Azure Developer CLI unterstützt die folgenden Clouds:

• Standardeinstellung für Azure Public (AzureCloud)
• Azure betrieben von 21Vianet Cloud (AzureChinaCloud)
• Azure US Government (AzureUSGovernment)

Die öffentliche Azure-Cloud ist der Standardwert und wird verwendet, wenn keine Cloud angegeben ist.

Authentifizierung

Wenn Sie zwischen Clouds wechseln, führen Sie azd auth login aus, um sich mit der ausgewählten Cloud zu authentifizieren.

Im folgenden Beispiel wird eine souveräne Cloud festgelegt und für die Authentifizierung mit dieser Cloud ausgeführt azd auth login :

azd config set cloud.name AzureUSGovernment
azd auth login

Cloudkonfigurationen

Clouds können auf Benutzer-, Projekt- oder Umgebungsebene konfiguriert werden. Die Reihenfolge der Konfigurationsrangfolge lautet:

1. Die Umgebungskonfiguration wird zuerst ausgewählt.
2. Wenn keine Cloud in der Umgebung konfiguriert ist, wird die Projektkonfiguration (azure.yaml) verwendet.
3. Wenn keine Cloud in der Projektkonfiguration festgelegt ist, wird die Benutzerkonfiguration (azd config set) verwendet.
4. Wenn keine Cloud in der Benutzerkonfiguration festgelegt ist, verwendet azd die öffentliche AzureCloud

Konfigurieren von Clouds mit Benutzereinstellungen (azd config set)

Richten Sie die Cloud für alle azd Vorgänge mit azd config ein

azd config set cloud.name AzureCloud

azd config set cloud.name AzureChinaCloud

azd config set cloud.name AzureUSGovernment

Konfigurieren von Clouds in der Datei "azure.yaml" des Projekts

Verwenden Sie das cloud Objekt, um den Namen der Cloud in der Datei "azure.yaml" des Projekts festzulegen.

name: project-name
cloud:
  name: AzureCloud

name: project-name
cloud:
  name: AzureChinaCloud

name: project-name
cloud:
  name: AzureUSGovernment

Konfigurieren von Clouds in der config.json-Datei einer Umgebung

Konfigurieren Sie die Cloud für bestimmte Umgebungen, indem Sie die Umgebungskonfigurationsdatei in .azure/<environment-name>/config.json. Dies ermöglicht beispielsweise die Bereitstellung in verschiedenen Clouds für unterschiedliche Umgebungen.

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

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

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

Unterstützte Befehle und Plattformen

Zu den unterstützten Befehlen gehören

• Authentifizierung
• Konfiguration
• bereitstellen
• herunter
• env
• Vorsorge
• oben
• Überwachen
• show

azd pipeline wird in Sovereign Clouds nicht unterstützt.

devcenter Die Plattform wird in Sovereign Clouds nicht unterstützt.

Bereitstellung mit Terraform

Wenn Sie die Bereitstellung in einer souveränen Cloud mithilfe azd und Terraform durchführen, muss die az CLI auch für die Verwendung der gewünschten Cloud konfiguriert werden. Siehe die Dokumentation von Terraform zum Authentifizieren mit der Azure CLI.

Legen Sie die Umgebungsvariable ARM_ENVIRONMENT auf die gewünschte Umgebung fest. Zu den allgemeinen Werten gehören:

• public (Standardwert)
• usgovernment
• china

Wählen Sie die entsprechende Cloud mit der az CLI aus:

az cloud set --name AzureCloud

az cloud set --name AzureChinaCloud

az cloud set --name AzureUSGovernment