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

2025-07-07

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

Внимание

Следующие образы выводятся из использования в централизованных пулах DevOps.

Azure Pipelines — Windows Server 2019
Ubuntu 20.04

Дополнительные сведения см. в разделе "График запланированного устаревания образов управляемых пулов DevOps".

Управляемые пулы 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/ubuntu-24_04-lts/skus/server/versions/latest",
                            "aliases": [
                                "ubuntu-24.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

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

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

В следующем примере определяются три изображения. Резервные агенты включены, 100% резервных агентов выделены на windows-2022 образ.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.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/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

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

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

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.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 Compute Gallery - Выберите из своих собственных образов в Azure Compute Gallery. Необходимо назначить роль читателя субъекту-службе DevOpsInfrastructure для образов коллекции вычислений Azure, которые вы хотите использовать. Дополнительные сведения см. в разделе Предоставление доступа к роли читателя субъекту-службы DevOpsInfrastructure.

Изображения Azure Pipelines

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

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

Дополнительные сведения о жизненном цикле образов управляемых пулов DevOps см. в разделе "Жизненный цикл образов".

При указании образа Azure Pipelines с помощью портала Azure всегда используется последняя версия образа.

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

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

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

При необходимости можно указать версию в wellKnownImageName параметре, например "wellKnownImageName": "windows-2022/latest" или "wellKnownImageName": "windows-2022/20250427.1.0". Если вы не указываете версию, latest используется.

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

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

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

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

Внимание

Следующие образы выводятся из использования в централизованных пулах DevOps.

Azure Pipelines — Windows Server 2019
Ubuntu 20.04

Дополнительные сведения см. в разделе "График запланированного устаревания образов управляемых пулов DevOps".

Выбранные изображения торговой площадки

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

Скриншот выбранных изображений из Маркетплейса.

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

Чтобы указать выбранный образ из Marketplace, укажите идентификатор ресурса этого образа, используя свойство resourceId.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

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

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

Образы галереи вычислительных ресурсов Azure

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

Windows Server 2022
Windows Server 2025
Windows 11
Ubuntu 22.04
Ubuntu 24.04
Debian 9
RHEL 8
RHEL 9
SUSE 12
SUSE 15

Внимание

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

Скриншот изображений галереи Azure Compute.

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

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

Предоставить доступ к роли "читатель" учётной записи службы DevOpsInfrastructure

Внимание

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

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

Настройки Значение

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

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

Участники Инфраструктура DevOps

Настройки	Значение
Роль	Читатель
Назначить доступ для	Субъект-служба
Участники	Инфраструктура DevOps

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

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

Совет

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

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

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

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

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

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

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

Чтобы настроить псевдонимы, укажите их в списке aliases . В следующем примере определяется один образ с одним псевдонимом.ubuntu-24.04-gen2

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

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

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

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

Образ Azure Pipelines	Предопределенный псевдоним
Azure Pipelines — Windows Server 2025	`windows-2025`
Azure Pipelines — Windows Server 2022	`windows-2022`
Azure Pipelines — Windows Server 2019	`windows-2019`
Azure Pipelines — Ubuntu 24.04	`ubuntu-24.04`
Azure Pipelines — Ubuntu 22.04	`ubuntu-22.04`

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

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

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

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-24.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 Pipelines — график упразднения образов Windows Server 2019
График устаревания образов Ubuntu 20.04

Azure Pipelines — расписание упразднения образов Windows Server 2019

Управляемые пулы DevOps удаляют образ Azure Pipelines — Windows Server 2019 .

Создание новых пулов с помощью Azure Pipelines — Windows Server 2019 будет отключено с 1 ноября 2025 г., но существующие пулы на этих образах будут продолжать работать до 31 декабря 2025 г.
31 декабря 2025 г. использование образа Azure Pipelines — Windows Server 2019 будет отключено. Агенты, использующие этот образ, не будут подготавливать и конвейеры не будут выполняться.

Чтобы ваши управляемые пулы DevOps продолжали работать, если вы используете образ Azure Pipelines — Windows Server 2019 , обновите его до образа Azure Pipelines — Windows Server 2022. Кроме того, можно использовать образ Windows Server 2019 из выбранных образов Marketplace или собственного образа Коллекции вычислений Azure Windows 2019. Обратите внимание, что образ Marketplace не включает предварительно установленное программное обеспечение, найденное на образе Azure Pipelines.

График устаревания образов Ubuntu 20.04

Поддержка Ubuntu 20.04 LTS уровня "Стандартный" завершается 31 мая 2025 г., и управляющие DevOps пулы удаляют образы Ubuntu 20.04 из выбранных образов в торговой площадке и образов Azure Pipelines.

Создание новых пулов с помощью образов Ubuntu 20.04 Selected Marketplace или образов Azure Pipelines будет отключено с 1 июня 2025 г., но существующие пулы на этих образах будут продолжать работать до 1 июля 2025 г.
1 июля 2025 г. пулы с использованием образов Ubuntu 20.04 Selected Marketplace или Azure Pipelines будут отключены. Агенты, использующие эти образы, не смогут запускать процессы, и потоки не будут выполняться.

Чтобы сохранить управляемые пулы DevOps, которые в настоящее время используют Ubuntu 20.04, обновите образы Ubuntu 20.04 до Ubuntu 22.04 или 24.04 (рекомендуется). Дополнительные сведения см. в разделе "Выбор образа пула". Если у вас несколько образов в пуле, обновите псевдонимы образов Ubuntu, чтобы конвейеры, требующие Ubuntu, запускались с использованием нужного образа.

См. также

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

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

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

Выберите образ для вашего пула

Изображения Azure Pipelines

Выбранные изображения торговой площадки

Образы галереи вычислительных ресурсов Azure

Предоставить доступ к роли "читатель" учётной записи службы DevOpsInfrastructure

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

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

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

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

Жизненный цикл изображений

Расписание нерекомендуемого изображения

Azure Pipelines — расписание упразднения образов Windows Server 2019

График устаревания образов Ubuntu 20.04

См. также

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

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