Configurer des images de pools DevOps managés

Les pools DevOps managés vous offrent plusieurs options pour les images de machine virtuelle pour l’exécution de pipelines dans votre pool. Vous pouvez créer votre pool à l’aide d’images de machine virtuelle sélectionnées Place de marché Azure, utiliser vos propres images azure Compute Gallery personnalisées ou utiliser les mêmes images que les agents hébergés par Microsoft Azure Pipelines.

Les pools DevOps managés peuvent être configurés avec une seule image ou plusieurs images. Lorsque votre pool a plusieurs images, vos pipelines spécifient l’image à exécuter à l’aide d’alias.

Choisir l’image de votre pool

Azure portal

Une image par défaut est sélectionnée lorsque vous créez un pool DevOps managé. Vous pouvez conserver le choix par défaut ou le modifier lors de la création du pool. Pour configurer l’image après la création du pool, accédez au pool de paramètres>, choisissez Ajouter dans la bibliothèque d’images, puis sélectionnez une ou plusieurs images pour votre pool.

Modèle ARM

Les images sont configurées dans la fabricProfile section des propriétés de ressource Pools DevOps managés.

L’exemple suivant spécifie trois images. Pour plus d’informations sur le schéma des images, consultez les sections suivantes de cet article.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
                            "aliases": [
                                "ubuntu-20.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

Chaque image peut avoir les propriétés suivantes.

Propriété	Description
aliases	Liste facultative d’alias. Vous pouvez ensuite faire référence à l’image à l’aide des alias au lieu de l’ID de ressource complet de l’image.
resourceID	ID de ressource de l’image à utiliser. Obligatoire lors de l’utilisation d’images azure Compute Gallery ou d’images de la Place de marché sélectionnées.
wellKnownImageName	Alias de l’image Azure Pipelines. Obligatoire lors de l’utilisation d’images Azure Pipelines.
buffer	Lorsque les agents de secours sont activés, buffer désigne le pourcentage d’agents de secours à allouer à cette image. Le total de toutes les valeurs d’image buffer doit être égal à 100.

L’exemple suivant définit trois images. Les agents de secours sont activés, avec 100 % des agents de secours alloués à l’image windows-2022 .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ],
        "buffer": "0"
    },
    {
        "buffer": "100",
        "wellKnownImageName": "windows-2022"
    },
    {
        "buffer": "0",
        "wellKnownImageName": "ubuntu-22.04"
    }
]

Azure CLI

Les images sont configurées dans la fabric-profile section des propriétés de ressource Pools DevOps managés.

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

L’exemple suivant montre la images section du fichier fabric-profile.json et spécifie trois images. Pour plus d’informations sur le schéma des images, consultez les sections suivantes de cet article.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Chaque image peut avoir les propriétés suivantes.

Propriété	Description
aliases	Liste facultative d’alias. Vous pouvez ensuite faire référence à l’image à l’aide des alias au lieu de l’ID de ressource complet de l’image.
resourceID	ID de ressource de l’image à utiliser. Obligatoire lors de l’utilisation d’images azure Compute Gallery ou d’images de la Place de marché sélectionnées.
wellKnownImageName	Alias de l’image Azure Pipelines. Obligatoire lors de l’utilisation d’images Azure Pipelines.
buffer	Lorsque les agents de secours sont activés, buffer désigne le pourcentage d’agents de secours à allouer à cette image. Le total de toutes les valeurs d’image buffer doit être égal à 100.

L’exemple suivant définit trois images. Les agents de secours sont activés, avec 100 % des agents de secours alloués à l’image windows-2022 .

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Si vous choisissez une seule image, tous les pipelines s’exécutent dans votre pool utilisent cette image. Si vous choisissez plusieurs images, vous pouvez spécifier l’image à utiliser par pipeline. Pour plus d’informations, consultez Utiliser plusieurs images par pool.

Vous pouvez choisir parmi les types d’images suivants.

• Images Azure Pipelines : choisissez parmi les mêmes images que celles utilisées par les agents hébergés par Microsoft.
• Images de la Place de marché sélectionnées : choisissez parmi un ensemble d’images de machine virtuelle publiées par Microsoft Place de marché Azure organisées.
• Images de la galerie de calcul Azure : choisissez parmi vos propres images de galeries de calcul Azure. Vous devez attribuer le rôle Lecteur au principal du service DevOpsInfrastructure pour les images de la galerie de calcul Azure que vous souhaitez utiliser. Pour plus d’informations, consultez Accorder l’accès au rôle Lecteur au principal du service DevOpsInfrastructure.

Images Azure Pipelines

Les pools DevOps managés fournissent plusieurs images préconfigurées qui ont le même logiciel que les agents hébergés par Microsoft sélectionnés pour Azure Pipelines.

Azure portal

Modèle ARM

Pour spécifier une image Azure Pipelines, fournissez l’alias de l’image à l’aide de la wellKnownImageName propriété. Consultez la liste des alias prédéfinis de l’image Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Azure CLI

Pour spécifier une image Azure Pipelines, fournissez l’alias de l’image à l’aide de la wellKnownImageName propriété. Consultez la liste des alias prédéfinis de l’image Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Chaque image inclut les logiciels installés suivants.

Image	Logiciels inclus
Azure Pipelines - Windows Server 2022	Logiciels inclus
Azure Pipelines - Windows Server 2019	Logiciels inclus
Azure Pipelines - Ubuntu 22.04	Logiciels inclus
Azure Pipelines - Ubuntu 20.04	Logiciels inclus

Images de la Place de marché sélectionnées

Les pools DevOps managés fournissent un ensemble d’images de machine virtuelle publiées par Microsoft organisées Place de marché Azure à utiliser dans vos pools.

Azure portal

Choisissez les images de la Place de marché sélectionnées, choisissez l’image souhaitée, puis choisissez la version souhaitée. Choisissez la dernière version pour toujours utiliser la dernière version de l’image.

Modèle ARM

Pour spécifier une image de la Place de marché sélectionnée, fournissez l’ID de ressource de l’image à l’aide de la resourceId propriété.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Azure CLI

Pour spécifier l’image de la Place de marché sélectionnée, fournissez l’ID de ressource de l’image à l’aide de la resourceId propriété.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Images de la galerie de calcul Azure

Choisissez les images de la galerie de calcul Azure pour spécifier une image à partir de toutes les galeries de calcul Azure disponibles dans vos abonnements. Les images généralisées avec les systèmes d’exploitation suivants sont prises en charge.

• Windows Server 2019
• Windows Server 2022
• Windows 11
• Ubuntu 20.04
• Ubuntu 22.04
• Ubuntu 24.04
• Debian 9
• RHEL 8
• RHEL 9
• SUSE 12
• SUSE 15

Important

Les pools DevOps managés prennent uniquement en charge les images de galerie de calcul Azure généralisées .

Azure portal

Modèle ARM

Pour spécifier une image de la galerie de calcul Azure, fournissez l’ID de ressource de l’image à l’aide de la resourceId propriété.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Azure CLI

Pour spécifier l’image de la Place de marché sélectionnée, fournissez l’ID de ressource de l’image à l’aide de la resourceId propriété.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Accorder au rôle Lecteur l’accès au principal du service DevOpsInfrastructure

Important

Attribuez le rôle Lecteur au principal du service DevOpsInfrastructure pour les images de la galerie de calcul Azure que vous souhaitez utiliser. Si vous sélectionnez une image de la galerie de calcul Azure qui n’a pas cet accès configuré, la création du pool échoue. Vous pouvez attribuer le rôle Lecteur individuellement au niveau de l’image ou au niveau de la galerie d’images pour toutes les images de la galerie.

1. Accédez à la ressource souhaitée dans la Portail Azure. Pour pouvoir utiliser toutes les images d’une galerie, accédez à Azure Compute Gallery dans le Portail Azure. Pour utiliser une image spécifique uniquement, accédez à cette image.

2. Sélectionnez Contrôle d’accès (IAM) .

3. Sélectionnez Ajouter>Ajouter une attribution de rôle pour ouvrir la page Ajouter une attribution de rôle.

4. Attribuez le rôle suivant. Pour connaître les étapes détaillées, consultez Attribuer des rôles Azure à l’aide du portail Azure.

   Paramètre	Valeur
   Rôle	Lecteur
   Attribuer l’accès à	Principal du service
   Membres	DevOpsInfrastructure

   

Utiliser plusieurs images par pool avec des alias

Si vous avez plusieurs images dans votre pool, vous pouvez configurer votre pipeline Azure DevOps pour utiliser une image spécifique en référençant un alias pour cette image.

Configurer des alias d’image

Azure portal

Pour ajouter et gérer des alias d’image, accédez à la section Images des paramètres du pool et choisissez ..., Ajouter un alias.

Ajoutez tous les alias souhaités à la liste des alias , puis choisissez Enregistrer.

L’exemple suivant montre un pool avec deux images Azure Pipelines et une image de la Place de marché sélectionnée. Les images Azure Pipeline ont leurs alias par défaut affichés, et l’image de la Place de marché sélectionnée a un alias configuré unique nommé ubuntu-20.04-gen2.

Modèle ARM

Pour configurer des alias, spécifiez-les dans la aliases liste. L’exemple suivant définit une image avec un seul alias nommé ubuntu-20.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

Azure CLI

Pour configurer des alias, spécifiez-les dans la aliases liste. L’exemple suivant définit une image avec un seul alias nommé ubuntu-20.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

Alias prédéfinis de l’image Azure Pipelines

En plus des alias que vous configurez, les images Azure Pipelines ont les alias prédéfinis suivants.

Image Azure Pipelines	Alias prédéfini
Azure Pipelines - Windows Server 2022	windows-2022
Azure Pipelines - Windows Server 2019	windows-2019
Azure Pipelines - Ubuntu 22.04	ubuntu-22.04
Azure Pipelines - Ubuntu 20.04	ubuntu-20.04

Utiliser des demandes pour spécifier une image

Si vous avez plusieurs images dans votre pool, vous pouvez configurer un pipeline pour qu’il s’exécute sur une image spécifique à l’aide d’une demande nommée ImageOverride. Lorsque vous spécifiez la ImageOverride demande dans votre pipeline, les pools DevOps managés envoient le travail uniquement aux agents utilisant cette image.

Pour exécuter un pipeline sur l’image Ubuntu 20.04 de l’exemple précédent qui avait un ubuntu-20.04-gen2 alias, spécifiez la demande suivante dans la pool section de votre pipeline.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-20.04-gen2

Important

Ne placez pas de guillemets autour du nom d’alias dans la ImageOverride demande, même s’il contient des espaces dans le nom.

Pour exécuter un pipeline à l’aide d’une image Azure Pipelines dans votre pool, utilisez l’alias dans le tableau précédent. Pour exécuter un pipeline sur l’image Windows Server 2022 d’Azure Pipelines à partir de l’exemple précédent, spécifiez la demande suivante dans la pool section de votre pipeline.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals windows-2022

Voir aussi

• Configurer les paramètres du pool