Partager via

Démarrage rapide : Créer un pool DevOps managé à l’aide d’un modèle ARM

  • Article

Cet article vous montre comment créer un pool DevOps managé à l’aide d’un modèle ARM et exécuter un pipeline dans le nouveau pool.

Prérequis

Avant de suivre les étapes décrites dans cet article, vous avez configuré votre abonnement Azure et votre organisation Azure DevOps pour une utilisation avec des pools DevOps managés, comme décrit dans l’article Prérequis. Ces étapes doivent être effectuées une seule fois par abonnement Azure et par organisation Azure DevOps.

Se connecter à Azure CLI

Ouvrez une invite de commandes (sur Windows, utilisez l’invite de commandes Windows ou PowerShell) et exécutez les commandes suivantes.

  1. Connectez-vous à Azure CLI.

    az login

  2. Si vous avez plusieurs abonnements Azure, définissez votre abonnement Azure par défaut.

    az account set --subscription "My subscription name"

    Pour obtenir la liste de vos abonnements, vous pouvez exécuter la commande suivante.

    az account list -o table

    Si vous avez plusieurs locataires ou souhaitez obtenir plus d’informations sur l’utilisation d’un abonnement Azure à l’aide d’Azure CLI, consultez Comment gérer les abonnements Azure avec Azure CLI.

Créer un groupe de ressources, Centre de développement et Centre de développement Project

  1. Suivez les étapes créer un centre de développement dans Créer et configurer un centre de développement pour les environnements de déploiement Azure à l’aide d’Azure CLI.

    Vous devez uniquement suivre les étapes décrites dans la section Créer un centre de développement. Notez le nom du groupe de ressources et Centre de développement nom.

  2. Suivez les étapes de création d’un projet dans Créer et configurer un projet à l’aide d’Azure CLI.

    Notez le id projet créé (et non le devCenterId).

Examiner et enregistrer le modèle

  1. Créez un nom de fichier local mdp-azure-deploy.json avec le contenu suivant. Ce fichier est un modèle ARM paramétrable qui crée une microsoft.devopsinfrastructure/pools ressource.

    {
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "type": "string"
        },
        "adoOrg": {
            "type": "string"
        },
        "devCenterResourceId": {
            "type": "string"
        },
        "imageName": {
            "type": "string"
        },
        "poolSize": {
            "type": "int"
        },
        "location": {
            "type": "string",
            "defaultValue": "eastus"
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('poolName')]",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "[parameters('adoOrg')]",
                            "parallelism": 1
                        }
                    ],
                    "permissionProfile": {
                        "kind": "CreatorOnly"
                    },
                    "kind": "AzureDevOps"
                },
                "devCenterProjectResourceId": "[parameters('devCenterResourceId')]",
                "maximumConcurrency": "[parameters('poolSize')]",
                "agentProfile": {
                    "kind": "Stateless"
                },
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    },
                    "images": [
                        {
                            "wellKnownImageName": "[parameters('imageName')]",
                            "buffer": "*"
                        }
                    ],
                    "kind": "Vmss"
                }
            }
        }
    ]
}

  2. Créez un autre fichier local nommé mdp-azure-deploy-parameters.json et enregistrez-le dans le même dossier que le premier fichier. Mettez à jour les propriétés suivantes pour qu’elles correspondent aux détails de votre environnement.

    Paramètre Valeur
    poolName Mettez à jour value avec le nom souhaité de votre pool. Le nom doit se composer de caractères alphanumériques, ., -ou _, et être compris entre 3 et 44 caractères. Le nom doit être globalement unique dans Azure.
    adoOrg Mettez à jour et remplacez valueyour-organization par le nom de votre organisation Azure DevOps.
    devCenterResourceId Effectuez une mise à jour value à id partir de l’étape Créer un groupe de ressources, Centre de développement et Centre de développement Étape De projet précédente.
    imageName Cet exemple est configuré pour utiliser une image Azure Pipelines et utilise l’image Windows Server 2022. Si vous souhaitez le modifier, choisissez parmi les alias prédéfinis de l’image Azure Pipelines. Les pools DevOps managés prennent également en charge les images azure Compute Gallery et les images de la Place de marché sélectionnées. Pour plus d’informations sur la configuration d’une ressource pools DevOps managées pour ces types d’images, consultez Configurer des images de pools DevOps managés.
    poolSize Mettez à jour value avec le nombre maximal d’agents que vous souhaitez pouvoir exécuter des travaux simultanés. Dans cet exemple, l’objet poolSize est 1.
    location Région Azure pour le pool. Dans cet exemple, la région est eastus. 
    {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "value": "my-first-managed-pool"
        },
        "adoOrg": {
            "value": "https://dev.azure.com/your-organization"
        },
        "devCenterResourceId": {
            "value": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
        },
        "imageName": {
            "value": "windows-2022"
        },
        "poolSize": {
            "value": 1
        },
        "location": {
            "value": "eastus"
        }
    }
}

Créer le pool DevOps managé

Ouvrez une invite de commandes (sur Windows, utilisez l’invite de commandes Windows ou PowerShell) et exécutez les commandes suivantes. Vous pouvez ignorer les deux premières commandes si votre session Azure CLI à partir de la première procédure est toujours active.

  1. Connectez-vous à Azure CLI.

    az login

  2. Si vous avez plusieurs abonnements Azure, définissez votre abonnement Azure par défaut.

    az account set --subscription "My subscription name"

    Pour obtenir la liste de vos abonnements, vous pouvez exécuter la commande suivante.

    az account list -o table

    Si vous avez plusieurs locataires ou souhaitez obtenir plus d’informations sur l’utilisation d’un abonnement Azure à l’aide d’Azure CLI, consultez Comment gérer les abonnements Azure avec Azure CLI.

  3. Accédez au dossier lorsque vous avez enregistré les deux fichiers JSON de l’étape précédente. Dans cet exemple, les fichiers sont enregistrés dans C:\examples.

    cd c:\examples

  4. Créez le pool DevOps managé. Remplacez <resourceGroupName> par le groupe de ressources créé à la première étape.

    az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json

    Si votre abonnement n’a pas la capacité de configurer votre pool avec la référence SKU de machine virtuelle Azure souhaitée et le nombre maximal d’agents, la création du pool échoue avec une erreur similaire au message suivant. Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97. Pour résoudre le problème, consultez Passer en revue les quotas de pools DevOps gérés.

Afficher votre pool créé dans le Portail Azure

  1. Connectez-vous au portail Azure.

  2. Recherchez les pools DevOps managés et sélectionnez-le dans les options disponibles.

  3. Choisissez votre nouveau pool DevOps managé dans la liste.

  4. Choisissez l’affichage JSON pour afficher le format JSON de votre ressource pools DevOps managés.

    Capture d’écran du bouton Affichage JSON dans la vue d’ensemble du pool.

Afficher le pool d’agents dans Azure DevOps

  1. Accédez au portail Azure DevOps et connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/{your-organization}).

  2. Accédez aux paramètres de l’organisation >.

    Capture d’écran du bouton Paramètres de l’organisation.

  3. Accédez aux >Agent et vérifiez que votre nouveau pool est répertorié. Si vous venez de créer le pool DevOps managé, il peut prendre quelques instants pour que le nouveau pool apparaisse dans la liste des agents.

    Capture d’écran de la liste des pools d’agents.

Exécuter un pipeline dans votre nouveau pool

Dans cette étape, nous allons créer un pipeline simple dans le référentiel par défaut d’un projet Azure DevOps et l’exécuter dans votre nouveau pool DevOps managé.

  1. Accédez au portail Azure DevOps et connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/{your-organization}).

  2. Accédez au projet dans lequel vous souhaitez exécuter le pipeline, puis choisissez Pipelines.

    Capture d’écran de la liste Projets.

  3. Choisissez Nouveau pipeline (ou Créez un pipeline s’il s’agit de votre premier pipeline).

    Capture d’écran du bouton nouveau pipeline.

  4. Choisissez Git Azure Repos.

    Capture d’écran des types de référentiels.

  5. Choisissez le référentiel portant le même nom que votre projet. Dans cet exemple, le projet est nommé FabrikamFiber. Nous choisissons donc le dépôt portant le même nom.

    Capture d’écran du dépôt FabrikamFiber.

  6. Choisissez Pipeline de démarrage.

    Capture d’écran de la liste des modèles de pipeline.

  7. Par défaut, le modèle de démarrage utilise un agent Linux hébergé par Microsoft. Modifiez le modèle de pipeline et modifiez la pool section afin qu’elle fasse référence au pool que vous avez créé lors des étapes précédentes.

    # Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest

    Dans cet exemple, les pools DevOps managés sont nommés fabrikam-managed-pool, donc remplacez vmImage: ubuntu-latest par name: fabrikam-managed-poolset spécifiez le nom de votre pool DevOps managé.

    # Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool

  8. Choisissez Enregistrer et exécuter, puis enregistrez et exécutez une deuxième fois pour confirmer.

    Capture d’écran du bouton Enregistrer et exécuter.

  9. S’il s’agit de la première exécution du pipeline dans ce pool, vous pouvez être invité à accorder des autorisations avant l’exécution du pipeline.

  10. Regardez l’exécution du pipeline dans Azure DevOps, et vous pouvez basculer vers le Portail Azure et voir l’agent en cours d’exécution dans la vue Agents.

Nettoyer les ressources

Lorsque vous avez terminé le démarrage rapide, supprimez les ressources créées si vous ne souhaitez pas continuer à les utiliser.

Pour supprimer le pool DevOps managé, Centre de développement et Centre de développement Project, vous pouvez les supprimer en supprimant le groupe de ressources qui les contient.

Voir aussi