Créer un environnement et y accéder en utilisant Azure CLI

Ce guide explique comment créer et accéder à un environnement dans un projet d’environnements de déploiement Azure existant à l’aide d’Azure CLI.

Prérequis

• Installer l’extension Azure CLI pour les environnements de déploiement Azure
• Créer et configurer un centre de développement à l’aide d’Azure CLI
• Créer et configurer un projet à l’aide d’Azure CLI

Créer un environnement

La création d’un environnement crée automatiquement les ressources nécessaires et un groupe de ressources pour les stocker. Le nom du groupe de ressources suit le modèle {projectName}-{environmentName}. Vous pouvez voir le groupe de ressources dans le portail Azure.

Complétez les étapes suivantes dans Azure CLI pour créer un environnement et configurer des ressources. Vous pouvez afficher les sorties telles que définies dans le modèle Azure Resource Manager spécifique (modèle ARM).

1. Connectez-vous à Azure CLI :

   az login
   

2. Installez l’extension Centre de développement Azure pour l’interface CLI.

   az extension add --name devcenter --upgrade
   

3. Répertoriez tous les projets d’environnements de déploiement Azure auxquels vous avez accès :

   az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
   

4. Configurez l’abonnement par défaut en tant qu’abonnement qui contient le projet :

   az account set --subscription <subscriptionName>
   

5. Configurez le groupe de ressources par défaut en tant que groupe de ressources qui contient le projet :

   az config set defaults.group=<resourceGroupName>
   

6. Répertoriez le type d’environnements que vous pouvez créer dans un projet spécifique :

   az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
   

7. Répertoriez les définitions d’environnement disponibles pour un projet spécifique :

   az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
   

8. Créez un environnement à l’aide d’une définition d’environnement (infrastructure en tant que modèle de code défini dans le fichier environment.yaml) dans la liste des définitions d’environnement disponibles :

   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
   

   Si l’élément spécifique environment-definition nécessite des paramètres, utilisez --parameters et fournissez les paramètres sous la forme d’une chaîne JSON ou d’un fichier JSON. Par exemple :

   $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
       --parameters $params
   

Résoudre une erreur d’autorisations

Vous devez disposer du rôle Utilisateur Environnements de déploiement, du rôle Administrateur de projets DevCenter ou d’un rôle intégré disposant des autorisations requises pour créer un environnement.

Si vous ne disposez pas des autorisations appropriées, l’environnement n’est pas créé. Un message d’erreur semblable à l’exemple suivant peut s’afficher :

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

Pour résoudre le problème, attribuez les autorisations appropriées : accordez l’accès à l’équipe de développement.

Accéder à un environnement

Pour accéder à un environnement :

1. Répertoriez les environnements existants disponibles dans un projet spécifique :

    az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
   

2. Afficher les points de terminaison d’accès à différentes ressources, comme défini dans les sorties du modèle ARM.

3. Accédez aux ressources spécifiques à l’aide des points de terminaison.

Déployer un environnement

az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Supprimer un environnement

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Contenu connexe

• Ajouter et configurer un catalogue à partir de GitHub ou d’Azure DevOps
• Ajouter et configurer une définition d’environnement