Partager via


Créer et configurer un projet à l’aide d’Azure CLI

Dans ce guide de démarrage rapide, vous allez créer un projet dans les environnements de déploiement Azure. Vous associez ensuite le projet au centre de développement que vous avez créé dans Créer et configurer un centre de développement à l’aide d’Azure CLI.

Une équipe d’ingénierie de plateforme crée généralement des projets et fournit l’accès aux équipes de développement. Les équipes de développement créent ensuite des environnements à l’aide des définitions d’environnement se connectent aux ressources individuelles et déploient des applications.

Conditions préalables

Catégorie Besoin
Abonnement Un compte Azure avec un abonnement actif. Créez un compte gratuitement.
Autorisations Rôle de contrôle d'accès en fonction du rôle Azure avec les autorisations pour créer et gérer des ressources dans l’abonnement, comme Contributeur ou Propriétaire.
Ressource - Centre de développement.

Création d’un projet

Pour créer un projet dans votre centre de développement :

  1. Connectez-vous à Azure CLI :

    az login
    
  2. Installez l’extension devcenter Azure CLI :

    az extension add --name devcenter --upgrade
    
  3. Configurez l’abonnement par défaut comme abonnement où réside votre centre de développement :

    az account set --subscription <subscriptionName>
    
  4. Configurez le groupe de ressources par défaut comme groupe de ressources où réside votre centre de développement :

    az configure --defaults group=<resourceGroupName>
    
  5. Configurez l’emplacement par défaut comme emplacement où réside votre centre de développement. L’emplacement du projet doit correspondre à l’emplacement du centre de développement.

    az configure --defaults location=eastus
    
  6. Récupérez l’ID de ressource du centre de développement :

    $DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
    Write-Output $DEVCID
    
  7. Créez le projet dans le centre de développement :

    az devcenter admin project create -n <projectName> `
    --description "My first project." `
    --dev-center-id $DEVCID
    
  8. Vérifiez que le projet a été créé avec succès :

    az devcenter admin project show -n <projectName>
    

Attribuer le rôle Propriétaire à une identité managée

Avant de pouvoir créer des types d’environnement, vous devez donner à l’identité managée qui représente votre centre de développement l’accès aux abonnements dans lesquels vous configurez les types d’environnement de projet.

Dans ce guide de démarrage rapide, vous attribuez le rôle Propriétaire à l’identité managée affectée par le système que vous avez configurée précédemment : attachez une identité managée affectée par le système.

  1. Récupérez l’ID d’abonnement :

    $SUBID = az account show --name <subscriptionName> --query id -o tsv
    Write-Output $SUBID
    
  2. Récupérez l’ID d’objet de l’identité du centre de développement en utilisant le nom de la ressource du centre de développement :

    $OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
    Write-Output $OID
    
  3. Attribuez au centre de développement le rôle de propriétaire sur l’abonnement :

    az role assignment create --assignee $OID `
    --role "Owner" `
    --scope "/subscriptions/$SUBID"
    

Configurer un projet

Pour configurer un projet, ajoutez un type d’environnement de projet :

  1. Récupérez l’ID de rôle pour le propriétaire de l’abonnement :

    # Remove the group default scope for next the command. 
    az configure --defaults group=
    
    $ROID = az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv
    Write-Output $ROID
    
    # Set the default resource group again.
    az configure --defaults group=<resourceGroupName>
    
  2. Afficher les types d’environnement autorisés pour le projet :

    az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name
    
  3. Choisissez un type d’environnement et créez-le pour le projet :

    $roles = "{`"$($ROID)`":{}}"
    az devcenter admin project-environment-type create `
        -n <availableEnvironmentType> `
        --project <projectName> `
        --identity-type "SystemAssigned" `
        --roles $roles `
        --deployment-target-id "/subscriptions/$SUBID" `
        --status Enabled
    

Remarque

Au moins une identité (affectée par le système ou par l’utilisateur) doit être activée pour l’identité de déploiement. L’identité est utilisée pour effectuer le déploiement de l’environnement pour le compte du développeur. En outre, l’identité attachée au centre de développement doit être affectée au rôle Propriétaire pour l’accès à l’abonnement de déploiement pour chaque type d’environnement.

Attribuer l’accès à l’environnement

Dans ce démarrage rapide, vous donnez accès à votre propre ID. Si vous le souhaitez, vous pouvez remplacer la valeur des --assignee commandes suivantes par l’ID d’objet d’un autre membre.

  1. Récupérez votre propre ID d’objet :

    $MYOID = az ad signed-in-user show --query id -o tsv
    Write-Output $MYOID
    
  2. Attribuez l’accès administrateur :

    az role assignment create --assignee $MYOID `
    --role "DevCenter Project Admin" `
    --scope "/subscriptions/$SUBID"
    
  3. Si vous le souhaitez, vous pouvez attribuer le rôle Utilisateur de l’environnement de développement :

    az role assignment create --assignee $MYOID `
    --role "Deployment Environments User" `
    --scope "/subscriptions/$SUBID"
    

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 environnements créés par d’autres utilisateurs.

Étape suivante

Dans ce guide de démarrage rapide, vous avez créé un projet et accordé l’accès au projet à votre équipe de développement. Pour savoir comment les membres de votre équipe de développement peuvent créer des environnements, accédez au guide de démarrage rapide suivant :