Utiliser Azure Developer CLI dans des clouds souverains

Ce guide explique comment configurer Azure Developer CLI pour provisionner des ressources et déployer des applications dans différents clouds.

Azure Developer CLI prend en charge les clouds suivants :

• Azure Public (AzureCloud) par défaut
• Azure géré par 21Vianet Cloud (AzureChinaCloud)
• Azure US Government (AzureUSGovernment)

Le cloud public Azure est la valeur par défaut et est utilisé si aucun cloud n’est spécifié.

Authentification

Lorsque vous passez d’un cloud à l’autre, exécutez-le azd auth login pour vous authentifier auprès du cloud défini.

L’exemple suivant définit un cloud souverain et s’exécute azd auth login pour s’authentifier auprès de ce cloud :

azd config set cloud.name AzureUSGovernment
azd auth login

Configurations du cloud

Les clouds peuvent être configurés au niveau de l’utilisateur, du projet ou de l’environnement. L’ordre de priorité de la configuration est le suivant :

1. La configuration de l’environnement est sélectionnée en premier
2. Si aucun cloud n’est configuré dans l’environnement, la configuration du projet (azure.yaml) est utilisée
3. Si aucun cloud n’est défini dans la configuration du projet, la configuration utilisateur (azd config set) est utilisée
4. Si aucun cloud n’est défini dans la configuration utilisateur, azd utilise le public AzureCloud

Configurer des clouds avec les paramètres utilisateur (azd config set)

Configurer le cloud pour toutes les opérations azd en utilisant azd config

azd config set cloud.name AzureCloud

azd config set cloud.name AzureChinaCloud

azd config set cloud.name AzureUSGovernment

Configurer des clouds dans le fichier azure.yaml du projet

Utilisez l’objet cloud pour définir le nom du cloud dans le fichier azure.yaml du projet.

name: project-name
cloud:
  name: AzureCloud

name: project-name
cloud:
  name: AzureChinaCloud

name: project-name
cloud:
  name: AzureUSGovernment

Configurer des clouds dans le fichier config.json d’un environnement

Configurez le cloud pour des environnements spécifiques en mettant à jour le fichier de configuration de l’environnement dans .azure/<environment-name>/config.json. Cela permet, par exemple, le déploiement dans différents clouds pour différents environnements.

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

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

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

Commandes et plateformes prises en charge

Les commandes prises en charge sont les suivantes :

• auth
• config
• déployer
• en bas
• environnement
• fourniture
• en haut
• écran
• show

azd pipeline n’est pas pris en charge dans les Clouds souverains.

devcenter la plateforme n’est pas prise en charge dans les clouds souverains.

Déploiement avec Terraform

Lorsque vous déployez sur un cloud souverain à l’aide azd de Terraform, l’interface az CLI doit également être configurée pour utiliser le cloud souhaité. Consultez la documentation de Terraform sur l’authentification à l’aide de l’Azure CLI.

Définissez la variable ARM_ENVIRONMENT d’environnement sur l’environnement souhaité. Exemples de valeurs courantes :

• public (valeur par défaut)
• usgovernment
• china

Sélectionnez le cloud approprié à l’aide de l’interface az CLI :

az cloud set --name AzureCloud

az cloud set --name AzureChinaCloud

az cloud set --name AzureUSGovernment