Utiliser des environnements Azure Developer CLI

Azure Developer CLI (azd) vous aide à créer et à gérer des environnements avec leurs propres configurations, telles que le développement, le test et la production. Cet article explique comment créer et gérer des environnements et comment les utiliser avec vos fichiers d’infrastructure Bicep.

Création d’environnements

Créez un environnement à l’aide de la azd env new commande :

azd env new <environment-name>

Par exemple, pour créer un environnement de développement :

azd env new dev

Lorsque vous exécutez une commande telle que azd up ou azd deploy, azd vous invite à sélectionner un abonnement Azure et un emplacement pour le nouvel environnement. Les paramètres d’invite sont stockés dans le nouvel environnement .env ou config.json les fichiers.

Vous pouvez également spécifier l’abonnement et l’emplacement directement dans la commande :

azd env new prod --subscription "My Production Subscription" --location eastus2

Liste des environnements

Pour afficher tous les environnements disponibles pour votre projet, utilisez :

azd env list

Cette commande affiche tous les environnements que vous avez créés, mettant en évidence l’environnement actif actuel :

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Basculer entre les environnements

Pour basculer vers un autre environnement, utilisez la azd env select commande :

azd env select <environment-name>

Par exemple, pour basculer vers un environnement de production :

azd env select prod

Comprendre l’environnement par défaut

Le fichier .azure/config.json de configuration global effectue le suivi de votre environnement actuellement sélectionné. Lorsque vous exécutez azd init et qu’aucun environnement n’existe encore, azd crée automatiquement votre premier environnement et le définit comme valeur par défaut. Si vous avez déjà un ou plusieurs environnements et que vous exécutez azd env new <name>, azd vous invite à choisir si le nouvel environnement est défini par défaut. Si vous refusez, le nouvel environnement est créé, mais votre sélection actuelle reste inchangée.

Vous pouvez remplacer temporairement l’environnement par défaut pour une seule commande à l’aide de l’indicateur --environment . L’utilisation de cet indicateur ne modifie pas la valeur par défaut pour les commandes futures.

Actualiser les paramètres d’environnement

Vous pouvez actualiser vos variables d’environnement locales à l’aide de la azd env refresh commande. Cette commande recherche le déploiement Azure le plus récent pour votre application, récupère les valeurs des variables d’environnement par nom, puis met à jour votre fichier local .env avec ces dernières valeurs pour l’environnement sélectionné. Par exemple, si vous avez approvisionné une version et prod que dev vous avez actuellement sélectionné l’environnementdev, il récupère la dernière sortie de ce déploiement pour remplir le fichier .env.

azd env refresh

L’actualisation de votre environnement est utile lorsque :

• Vous souhaitez vous assurer que votre fichier local .env reflète les dernières sorties de votre infrastructure (comme les chaînes de connexion, les points de terminaison, etc.).
• Vous devez synchroniser les variables d’environnement après qu’un coéquipier a mis à jour l’environnement.

Si d’autres membres de l’équipe ont apporté des modifications aux configurations d’environnement ou si vous avez apporté des modifications via le portail Azure, vous pouvez actualiser vos paramètres d’environnement local avec :

Exécuter des commandes dans des environnements spécifiques

Vous pouvez exécuter de nombreuses azd commandes dans un environnement spécifique sans modifier votre environnement actif à l’aide du ou -e de l’indicateur --environment :

azd up --environment dev

Cette commande exécute le up workflow (provisionner et déployer) dans l’environnement dev sans modifier votre environnement actif.

Vous pouvez également passer d’abord à votre environnement prévu :

azd env select test
azd up

Supprimer des ressources d’environnement

Pour supprimer les ressources Azure pour un environnement spécifique, à l’aide de la azd down commande :

azd down <environment-name>

Utiliser le nom de l’environnement dans les fichiers d’infrastructure

Vous pouvez utiliser la AZURE_ENV_NAME variable à partir du fichier de .env votre environnement pour personnaliser vos déploiements d’infrastructure dans Bicep. Cela est utile pour nommer, marquer ou configurer des ressources en fonction de l’environnement actuel.

1. azd définit la variable d’environnement AZURE_ENV_NAME lorsque vous initialisez un projet.

   AZURE_ENV_NAME=dev
   

2. Dans votre main.parameters.json fichier, référencez la variable d’environnement afin de azd remplacer sa valeur :

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "environmentName": {
         "value": "${AZURE_ENV_NAME}"
       }
     }
   }
   

   Lorsque vous déployez avec azd, la valeur à partir de .env laquelle est passée votre fichier Bicep .main.parameters.json

3. Dans votre modèle Bicep, définissez un paramètre pour le nom de l’environnement :

   param environmentName string
   

4. Vous pouvez utiliser le environmentName paramètre pour baliser les ressources, ce qui facilite l’identification de l’environnement auquel appartient une ressource :

   param environmentName string
   
   resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
     name: 'mystorage${uniqueString(resourceGroup().id)}'
     location: resourceGroup().location
     sku: {
       name: 'Standard_LRS'
     }
     kind: 'StorageV2'
     tags: {
       Environment: environmentName
       Project: 'myproject'
     }
   }
   

Cette approche permet de gérer les ressources, le suivi des coûts et l’automatisation en associant chaque ressource à son environnement de déploiement.

Étapes suivantes