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

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

Внимание

Следующие образы больше не рекомендуются к использованию в управляемых пулах DevOps:

Azure Pipelines — Windows Server 2019
Ubuntu 20.04

Дополнительные сведения см. в разделе "График запланированного устаревания образов управляемых пулов 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": "2025-01-21",
            "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 или выбранных образов 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/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 Gallery или выбранных образов Marketplace.
`wellKnownImageName`	Псевдоним для образа Azure Pipelines. Требуется при использовании образов Azure Pipelines.
`buffer`	При включении резервных агентов значение определяет, какой процент резервных агентов следует выделить этому изображению. Общее количество всех значений изображения `buffer` должно быть равно 100.

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

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

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

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-01-21' = {
  name: 'fabrikam-managed-pool'
  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` резервных агентов, выделенных этому изображению. Общее количество всех значений изображения `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'
  }
]

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

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

Используйте шаблоны: измените порядок изображений в списке imagesfabricProfile в разделе.
Используйте перетаскивание. Упорядочивание изображений в списке изображений на портале Azure.

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

Образы Azure Pipelines: выберите из тех же образов, что и агенты, размещенные на платформе Microsoft.
Выбранные образы marketplace: выберите из курированного набора образов ВМ, опубликованных корпорацией Майкрософт.
Образы коллекции вычислений Azure: выберите из собственных образов коллекции вычислений Azure. Необходимо назначить роль читателя принципалу службы DevOpsInfrastructure для образов Azure Compute Gallery, которые вы хотите использовать. Дополнительные сведения см. в разделе "Предоставление доступа читателя" к субъекту-службе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"
    }
]

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

Можно указать версию в wellKnownImageName параметре (например wellKnownImageName: 'windows-2022/latest' , или wellKnownImageName: 'windows-2022/20250427.1.0'). Если вы не указываете версию, latest используется.

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

Изображение	Включенное программное обеспечение
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 предоставляют управляемый набор образов виртуальных машин, опубликованных корпорацией Майкрософт, для использования в пулах.

Снимок экрана, показывающий выбранные изображения из 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"
    }
]

Чтобы указать выбранное изображение на 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 Compute Gallery, чтобы указать образ из любой галереи, доступной в ваших подписках. Поддерживаются обобщенные образы со следующими операционными системами:

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

Внимание

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

Управляемые пулы DevOps не поддерживают образы Azure Compute Gallery, созданные на основе платного базового образа. Если вы получаете сообщение об ошибке "База образов не поддерживается, так как это платный образ. Укажите другой образ, бесплатный", выберите другой образ коллекции вычислений Azure на основе виртуальной машины, созданной с помощью бесплатного плана ценообразования для базового образа.

Снимок экрана, показывающий изображения в галерее вычислений Azure.

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

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

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

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

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

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

Предоставление ролевого доступа для чтения служебному принципалу DevOpsInfrastructure

Внимание

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

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

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

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

Назначить доступ для участник службы

Участники DevOpsInfrastructure

Настройки	Значение
Роль	Читатель
Назначить доступ для	участник службы
Участники	`DevOpsInfrastructure`

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

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

Используйте шаблоны: измените порядок изображений в списке imagesfabricProfile в разделе.
Используйте перетаскивание. Упорядочивание изображений в списке изображений на портале Azure.

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

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

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

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

Снимок экрана, на котором отображена панель «Псевдоним».

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

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

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

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 будет отключено. Агенты, использующие этот образ, не предоставляют ресурсы, и потоки сборки не выполняются.

Чтобы обеспечить работу пулов при использовании образа 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 Standard закончилась 31 мая 2025 г. и управляемые пулы DevOps удалили образы Ubuntu 20.04 из выбранных образов Marketplace и образов Azure Pipelines.

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

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

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

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

Были ли сведения на этой странице полезными?

Last updated on 2025-10-02

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

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

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

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

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

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

Предоставление ролевого доступа для чтения служебному принципалу DevOpsInfrastructure

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

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

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

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

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

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

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

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

Связанный контент

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

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