Usare l'interfaccia della riga di comando per sviluppatori di Azure nei cloud sovrani

Questa guida illustra come configurare l'interfaccia della riga di comando per sviluppatori di Azure per effettuare il provisioning delle risorse e distribuire applicazioni in cloud diversi.

L'interfaccia della riga di comando per sviluppatori di Azure supporta i cloud seguenti:

  • Impostazione predefinita di Azure Public (AzureCloud)
  • Azure gestito da 21Vianet Cloud (AzureChinaCloud)
  • Azure US Government (AzureUSGovernment)

Il cloud pubblico di Azure è l'impostazione predefinita e viene usato se non viene specificato alcun cloud.

Autenticazione

Quando si passa da un cloud all'altro, eseguire azd auth login per eseguire l'autenticazione con il cloud impostato.

L'esempio seguente imposta un cloud sovrano ed esegue azd auth login per l'autenticazione con tale cloud:

azd config set cloud.name AzureUSGovernment
azd auth login

Configurazioni cloud

I cloud possono essere configurati a livello di utente, progetto o ambiente. L'ordine di precedenza della configurazione è:

  1. La configurazione dell'ambiente è selezionata per prima
  2. Se nell'ambiente non è configurato alcun cloud, viene usata la configurazione del progetto (azure.yaml)
  3. Se nella configurazione del progetto non è impostato alcun cloud, viene usata la configurazione utente (azd config set)
  4. Se nella configurazione utente non è impostato alcun cloud, azd usa il pubblico AzureCloud

Configurare le cloud con le impostazioni utente (azd config set)

Impostare il cloud per tutte le azd operazioni usando azd config

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

Configurare i cloud nel file azure.yaml del progetto

Usare l'oggetto cloud per impostare il nome del cloud nel file azure.yaml del progetto.

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

Configurare i cloud nel file di config.json di un ambiente

Configurare il cloud per ambienti specifici aggiornando il file di configurazione dell'ambiente in .azure/<environment-name>/config.json. Ciò consente, ad esempio, la distribuzione in cloud diversi per ambienti diversi.

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

Comandi e piattaforme supportati

I comandi supportati includono

  • auth
  • configurazione
  • implementare
  • giù
  • Env
  • provvigione
  • su
  • monitoraggio
  • show

azd pipeline non è supportato nei Cloud Sovrani.

devcenter la piattaforma non è supportata nei cloud sovrani.

Distribuzione con Terraform

Quando si esegue la distribuzione in un cloud sovrano usando azd e Terraform, l'interfaccia della az riga di comando deve essere configurata anche per l'uso del cloud desiderato. Consultare la documentazione di Terraform sull'autenticazione tramite Azure CLI.

Impostare la variabile ARM_ENVIRONMENT di ambiente sull'ambiente desiderato. I valori comuni includono:

  • public (impostazione predefinita)
  • usgovernment
  • china

Selezionare il cloud appropriato usando la CLI az.

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