Partager via

Créer et accéder à un environnement à l’aide d’Azure CLI

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

Prerequisites

Catégorie Requirement
Installation Extension Azure CLI pour les environnements de déploiement Azure.
Procedure Fin de la création et de la configuration d’un centre de développement à l’aide d’Azure CLI.
Procedure Fin de la création et de la configuration d’un projet à l’aide d’Azure CLI.
Permissions Pour créer un environnement : le rôle Utilisateur des environnements de déploiement , le rôle Administrateur de projet DevCenter ou un rôle intégré disposant d’autorisations appropriées.

Créer un environnement

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

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

Note

Seuls les utilisateurs disposant du rôle Utilisateur des environnements de déploiement , du rôle Administrateur de projet DevCenter ou d’un rôle intégré disposant d’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 environnements créés par d’autres utilisateurs.

  1. Connectez-vous à Azure CLI :

    az login

  2. Installez ou mettez à niveau l’extension du 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 comme abonnement qui contient le projet :

    az account set --subscription <subscriptionName>

  5. Configurez le groupe de ressources par défaut comme 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 (modèle infrastructure-as-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 la définition d’environnement spécifique 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

Note

Vous pouvez utiliser --help pour afficher plus de détails sur n’importe quelle commande, arguments acceptés et exemples. Par exemple, utilisez cette option az devcenter dev environment create --help pour afficher plus de détails sur la création d’un environnement.

Résoudre une erreur d’autorisation

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

Si vous n’avez pas les autorisations appropriées, l’environnement n’est pas créé. Un message d’erreur semblable à l’exemple suivant peut apparaître :

(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épertorier les environnements existants disponibles dans un projet spécifique :

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

  2. Affichez 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-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

  • Last updated on