Configurer des images de pools DevOps managés

Article
10/18/2024

Important

Les pools DevOps managés sont actuellement en préversion. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

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

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.

Capture d’écran de la configuration de l’image.

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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscrition_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/subscrition_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"
    }
]

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/subscrition_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/subscrition_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.

Capture d’écran des images Azure Pipelines.

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"
    }
]

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

Capture d’écran des images de la Place de marché sélectionnées.

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.

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/subscrition_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

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/subscrition_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
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 .

Capture d’écran des images de la galerie de calcul Azure.

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/subscrition_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

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/subscrition_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.

Accédez à la ressource souhaitée dans le 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.
Sélectionnez Contrôle d’accès (IAM) .
Sélectionnez Ajouter>Ajouter une attribution de rôle pour ouvrir la page Ajouter une attribution de rôle.
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

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

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.

Capture d’écran du volet alias.

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.

Capture d’écran d’un pool avec plusieurs images avec des alias.

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/subscrition_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"
        ]
    }
]

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/subscrition_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

Partager via

Configurer des images de pools DevOps managés

Choisir l’image de votre pool

Images Azure Pipelines

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

Images de la galerie de calcul Azure

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

Utiliser plusieurs images par pool avec des alias

Configurer des alias d’image

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

Utiliser des demandes pour spécifier une image

Voir aussi

Commentaires

Ressources supplémentaires