Partager via


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

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).

Remarque

Seuls les utilisateurs qui disposent 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 appropriées peuvent créer un environnement. Les utilisateurs disposant du rôle Lecteur d’environnements de déploiement peuvent afficher leurs propres environnements et ceux créés par d’autres utilisateurs.

  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
    

Notes

Vous pouvez utiliser --help pour afficher plus de détails sur toutes les commandes, arguments acceptés et exemples. Par exemple, utilisez az devcenter dev environment create --help pour afficher plus d’informations sur la création de l’environnement.

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"