Настройка образов управляемых пулов DevOps

Статья
02/10/2025

Управляемые пулы DevOps предоставляют несколько вариантов для образов виртуальных машин для выполнения конвейеров в пуле. Вы можете создать пул с помощью выбранных образов виртуальных машин Azure Marketplace, использовать собственные образы коллекции вычислений Azure или использовать те же образы, что и размещенные в Майкрософт агенты Azure Pipelines.

Управляемые пулы DevOps можно настроить с одним изображением или несколькими изображениями. При наличии нескольких образов пула конвейеры должны указывать образ, на который они должны работать с помощью псевдонимов .

Выбор образа пула

При создании управляемого пула DevOps выбран образ по умолчанию. Вы можете сохранить выбор по умолчанию или изменить его во время создания пула. Чтобы настроить образ после создания пула, перейдите в пул>" и выберите один или несколько образов для пула.

Снимок экрана: настройка образа.

Образы настраиваются в fabricProfile разделе свойств ресурсов управляемых пулов DevOps.

В следующем примере указаны три изображения. Дополнительные сведения о схеме изображений см. в следующих разделах этой статьи.

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

Каждое изображение может иметь следующие свойства.

Свойство	Description
`aliases`	Необязательный список псевдонимов. Затем можно ссылаться на изображение с помощью псевдонимов вместо полного идентификатора ресурса образа.
`resourceID`	Идентификатор ресурса используемого образа. Требуется при использовании образов коллекции вычислений Azure или выбранных образов Marketplace.
`wellKnownImageName`	Псевдоним образа Azure Pipelines. Требуется при использовании образов Azure Pipelines.
`buffer`	Если `buffer` будет выделен для этого образа. Общее количество всех значений изображения `buffer` должно быть равно 100.

В следующем примере определяются три изображения. Резервные агенты включены, с 100% резервных агентов, выделенных 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"
    }
]

Образы настраиваются в fabric-profile разделе свойств ресурсов управляемых пулов DevOps.

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

В следующем примере показан images раздел файла fabric-profile.json и указывает три изображения. Дополнительные сведения о схеме изображений см. в следующих разделах этой статьи.

{
  "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": {...}
  }
}

Каждое изображение может иметь следующие свойства.

Свойство	Description
`aliases`	Необязательный список псевдонимов. Затем можно ссылаться на изображение с помощью псевдонимов вместо полного идентификатора ресурса образа.
`resourceID`	Идентификатор ресурса используемого образа. Требуется при использовании образов коллекции вычислений Azure или выбранных образов Marketplace.
`wellKnownImageName`	Псевдоним образа Azure Pipelines. Требуется при использовании образов Azure Pipelines.
`buffer`	Если `buffer` будет выделен для этого образа. Общее количество всех значений изображения `buffer` должно быть равно 100.

{
  "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": {...}
  }
}

При выборе одного образа все конвейеры в пуле выполняются с использованием этого образа. При выборе нескольких образов можно указать изображение, используемое на основе конвейера. Дополнительные сведения см. в разделе "Использование нескольких образов для каждого пула".

Внимание

Если у вас несколько образов в пуле, и не используются условия в конвейерах для выбора образа, то конвейеры запускаются, используя первый указанный образ в пуле. Вы можете изменить порядок изображений в пуле, изменив порядок изображений в списке images в разделе fabricProfile (при использовании шаблонов ) или упорядочив изображения в списке изображений на портале Azure с помощью перетаскивания.

Вы можете выбрать один из следующих типов изображений.

Образы Azure Pipelines. Выберите один и тот же образ, который используют агенты, размещенные корпорацией Майкрософт.
Выбранные образы Marketplace. Выберите из набора проверенных образов виртуальных машин Microsoft Azure Marketplace.
Образы коллекции вычислений Azure. Выбор из собственных образов коллекций вычислений Azure. Необходимо назначить роль читателя субъекту-службе DevOpsInfrastructure для образов коллекции вычислений Azure, которые вы хотите использовать. Дополнительные сведения см. в разделе "Предоставление доступа к роли читателя" к субъекту-службе DevOpsInfrastructure.

Образы Azure Pipelines

Управляемые пулы DevOps предоставляют несколько предварительно настроенных образов, которые имеют то же программное обеспечение, что и выбранные агенты, размещенные Корпорацией Майкрософт для Azure Pipelines.

Снимок экрана: образы Azure Pipelines.

Чтобы указать образ Azure Pipelines, укажите псевдоним изображения с помощью wellKnownImageName свойства. См. список предопределенных псевдонимов образа Azure Pipelines.

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

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

Каждый образ включает в себя следующее установленное программное обеспечение.

Изображения	Включенное программное обеспечение
Azure Pipelines — Windows Server 2022	Включенное программное обеспечение
Azure Pipelines — Windows Server 2019	Включенное программное обеспечение
Azure Pipelines — Ubuntu 22.04	Включенное программное обеспечение
Azure Pipelines — Ubuntu 20.04	Включенное программное обеспечение

Выбранные образы Marketplace

Управляемые пулы DevOps предоставляют набор проверенных образов виртуальных машин Microsoft Azure Marketplace для использования в пулах.

Снимок экрана: выбранные образы Marketplace.

Выберите выбранные образы Marketplace, выберите нужный образ и выберите нужную версию. Выберите последнюю версию образа, чтобы всегда использовать последнюю версию образа.

Чтобы указать выбранный образ Marketplace, укажите идентификатор ресурса образа с помощью resourceId свойства.

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

Чтобы указать выбранный образ Marketplace, укажите идентификатор ресурса образа с помощью resourceId свойства.

"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

Выберите образы коллекции вычислений Azure, чтобы указать образ из любых коллекций вычислений Azure, доступных в подписках. Поддерживаются обобщенные образы со следующими операционными системами.

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

Внимание

Управляемые пулы DevOps поддерживают только общие образы коллекции вычислений Azure.

Снимок экрана: образы коллекции вычислений Azure.

Чтобы указать образ коллекции вычислений Azure, укажите идентификатор ресурса образа с помощью resourceId свойства.

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

Чтобы указать выбранный образ Marketplace, укажите идентификатор ресурса образа с помощью resourceId свойства.

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

Предоставление доступа к роли читателя субъекту-службе DevOpsInfrastructure

Внимание

Назначьте роль читателя субъекту-службе DevOpsInfrastructure для образов коллекции вычислений Azure, которые вы хотите использовать. Если выбрать образ коллекции вычислений Azure, который не настроен на этот доступ, создание пула завершается сбоем. Роль читателя можно назначить отдельно на уровне изображения или на уровне коллекции изображений для всех изображений в коллекции.

Перейдите к требуемому ресурсу в портал Azure. Чтобы использовать все изображения в коллекции, перейдите в коллекцию вычислений Azure в портал Azure. Чтобы использовать только определенное изображение, перейдите к следующему изображению.
Выберите Управление доступом (IAM) .
Выберите Добавить>Добавить назначение ролей, чтобы открыть страницу Добавление назначения ролей.
Назначьте следующую роль. Подробные инструкции см. в статье Назначение ролей Azure с помощью портала Microsoft Azure.

Параметр Значение

Роль Читатель

Назначить доступ для Субъект-служба

Участники DevOpsInfrastructure

Параметр	Значение
Роль	Читатель
Назначить доступ для	Субъект-служба
Участники	DevOpsInfrastructure

Использование нескольких образов для пула с псевдонимами

Если у вас несколько образов в пуле, можно настроить конвейер Azure DevOps для использования определенного образа, ссылаясь на псевдоним для этого образа.

Если у вас в пуле несколько образов, и в конвейерах не указаны требования для выбора образа, то конвейеры будут выполнены с использованием первого образа в списке вашего пула. Вы можете изменить порядок изображений в пуле, изменив порядок изображений в списке images в разделе fabricProfile (при использовании шаблонов ) или упорядочив изображения в списке изображений на портале Azure с помощью перетаскивания.

Совет

Если у ваших пайплайнов возникают проблемы после первого добавления нового образа в пул, проверьте порядок образов в списке и рассмотрите возможность использования требований и псевдонимов, чтобы явно указать, какой образ следует использовать для каждого пайплайна.

Настройка псевдонимов изображений

Чтобы добавить псевдонимы изображений и управлять ими, перейдите в раздел "Изображения " параметров пула и выберите ..., добавьте псевдоним.

Добавьте все нужные псевдонимы в список псевдонимов и нажмите кнопку "Сохранить".

Снимок экрана: область псевдонима.

В следующем примере показан пул с двумя образами Azure Pipelines и одним выбранным изображением Marketplace. Образы Azure Pipeline отображаются по умолчанию, а выбранный образ Marketplace имеет один настроенный псевдоним ubuntu-20.04-2-го поколения.

Снимок экрана: пул с несколькими изображениями с псевдонимами.

Чтобы настроить псевдонимы, укажите их в списке aliases . В следующем примере определяется один образ с одним псевдонимом.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"
        ]
    }
]

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

Помимо всех настроенных псевдонимов образы Azure Pipelines имеют следующие предопределенные псевдонимы.

Образ Azure Pipelines	Предопределенный псевдоним
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`

Использование требований для указания изображения

Если в пуле несколько образов, можно настроить конвейер для запуска на определенном изображении с помощью запроса с именем ImageOverride. При указании ImageOverride спроса в конвейере управляемые пулы DevOps отправляют задание только агентам с помощью этого образа.

Чтобы запустить конвейер на образе Ubuntu 20.04 из предыдущего примера с псевдонимом ubuntu-20.04-gen2 , укажите следующий запрос в pool разделе конвейера.

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

Внимание

Не помещайте кавычки вокруг имени псевдонима ImageOverride в запросе, даже если он содержит пробелы в имени.

Чтобы запустить конвейер с помощью образа Azure Pipelines в пуле, используйте псевдоним в предыдущей таблице. Чтобы запустить конвейер на образе Windows Server 2022 Azure Pipelines из предыдущего примера, укажите следующий запрос в pool разделе конвейера.

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

См. также

Настройка параметров пула

Поделиться через

Настройка образов управляемых пулов DevOps

Выбор образа пула

Образы Azure Pipelines

Выбранные образы Marketplace

Образы коллекции вычислений Azure

Предоставление доступа к роли читателя субъекту-службе DevOpsInfrastructure

Использование нескольких образов для пула с псевдонимами

Настройка псевдонимов изображений

Предопределенные псевдонимы образа Azure Pipelines

Использование требований для указания изображения

См. также

Обратная связь

Дополнительные ресурсы