托管 DevOps 池提供了多个虚拟机映像选项，以用于在池中运行管道。 你可以使用所选的 Azure 市场 VM 映像创建池，使用你自己的自定义 Azure Compute Gallery 映像，或者使用与 Azure Pipelines Microsoft 托管代理相同的映像。
重要
以下映像在托管 DevOps 池中已被弃用。
- Azure Pipelines - Windows Server 2019
- Ubuntu 20.04
有关详细信息，请参阅托管 DevOps 池映像弃用计划。
可以使用单个映像或多个映像配置托管 DevOps 池。 当池有多个映像时，管道应使用别名指定要运行的映像。
选择池的映像
创建托管 DevOps 池时会选择默认映像。 可以保留默认选项，也可以在创建池期间更改选项。 若要在创建池后配置映像，请转到 “设置>池”， 从映像库中选择“添加”，然后为池选择一个或多个映像。
映像是在托管 DevOps 池资源属性的 fabricProfile 部分中配置的。
以下示例指定三个映像。 有关映像架构的更多信息，请参阅本文中的以下部分。
{
"$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"
}
]
}
}
}
]
}
每个映像可以具有以下属性。
以下示例定义三个映像。 已启用备用代理，其中 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"
}
]
映像是在托管 DevOps 池资源属性的 fabric-profile 部分中配置的。
az mdp pool create \
--fabric-profile fabric-profile.json
# other parameters omitted for space
以下示例显示 images 文件的节，并指定三个图像。 有关映像架构的更多信息，请参阅本文中的以下部分。
{
"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": {...}
}
}
每个映像可以具有以下属性。
以下示例定义三个映像。 已启用备用代理，其中 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": {...}
}
}
映像是在托管 DevOps 池资源属性的 fabricProfile 部分中配置的。
以下示例指定三个映像。 有关映像架构的更多信息，请参阅本文中的以下部分。
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'
}
]
}
}
}
每个映像可以具有以下属性。
以下示例定义三个映像。 已启用备用代理，其中 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'
}
]
如果选择单个映像，则所有管道都会在池中使用该映像运行。 如果选择多个映像，则可以指定要在每个管道上使用的映像。 有关更多信息，请参阅每个池使用多个映像。
重要
如果你的池中有多个映像，并且不在管道中使用需求来指定映像，那么管道将使用池中第一个列出的映像运行。 可以通过更改images部分中的fabricProfile列表中的图像顺序（如果使用模板），或者在 Azure 门户中使用拖放功能对映像列表中的图像进行排序来调整池中的图像顺序。
可以从下列映像类型中选择。
Azure Pipelines 映像
托管 DevOps 池提供了多个预配置映像，这些映像与 Azure Pipelines 的所选 Microsoft 托管代理具有相同的软件。
托管 DevOps 池中提供的 Azure Pipelines 映像的生命周期遵循 Microsoft 托管代理映像的生命周期。 如果 Microsoft 托管代理中的映像被弃用，则相应的托管 DevOps 池也会在相似的时间范围内被弃用。 Microsoft托管代理中可用的映像版本可能与托管 DevOps 池中针对同一映像类型的可用映像版本略有不同。
有关托管 DevOps 池映像生命周期的更多信息，请参阅映像生命周期。
使用 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"
}
]
可以选择在设置中 wellKnownImageName 指定版本，例如 "wellKnownImageName": "windows-2022/latest" 或 "wellKnownImageName": "windows-2022/20250427.1.0"。 如果未指定版本， latest 则使用。
要指定 Azure Pipelines 映像，请使用 wellKnownImageName 属性提供映像的别名。 请参阅 Azure Pipelines 映像预定义别名的列表。
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 池提供一组精选的 Microsoft 发布 Azure 市场 VM 映像，以用于你的池中。
选择 “所选市场映像”，选择所需的映像，然后选择所需的版本。 选择 最新版本 以始终使用最新版本的映像。
若要指定选定的市场映像，请使用 resourceId 属性提供映像的资源 ID。
"images": [
{
"resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
}
]
若要指定选定的市场映像，请使用 resourceId 属性提供映像的资源 ID。
"images": [
{
"resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
}
]
若要指定选定的市场映像，请使用 resourceId 属性提供映像的资源 ID。
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 Compute Gallery 映像
选择 Azure 计算库映像 以指定订阅中提供的任何 Azure 计算库中的映像。 支持以下操作系统的通用化映像。
- 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 Compute Gallery 映像。
托管的 DevOps 池不支持使用付费基础映像创建的 Azure 计算库映像。 如果收到错误信息，例如 “映像基础不受支持，因为它是付费映像。请提供免费映像。”，请选择使用免费定价计划创建的虚拟机的 Azure 计算库中的不同映像。
若要指定 Azure Compute Gallery 映像，请使用 resourceId 属性提供映像的资源 ID。
"images": [
{
"resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
}
]
若要指定 Azure Compute Gallery 映像，请使用 resourceId 属性提供映像的资源 ID。
"images": [
{
"resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
}
]
若要指定 Azure Compute Gallery 映像，请使用 resourceId 属性提供映像的资源 ID。
images: [
{
resourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404'
}
]
为 DevOpsInfrastructure 服务主体授予“读取者”角色访问权限
重要
将“读取者”角色分配给要使用的 Azure Compute Gallery 映像的 DevOpsInfrastructure 服务主体。 如果选择未配置此访问权限的 Azure Compute Gallery 映像，池创建会失败。 可以在映像级别或库中所有映像的映像库级别单独分配读者角色。
转到 Azure 门户中的所需资源。 为了能够使用库中的所有映像，请转到 Azure 门户中的 Azure Compute Gallery。 若要仅使用特定映像，请转到该映像。
选择“访问控制(IAM)”。
选择添加>添加角色分配，打开“添加角色分配”页面。
分配以下角色。 有关详细步骤，请参阅 使用 Azure 门户分配 Azure 角色。
| 设置 |
值 |
| 角色 |
读取者 |
| 将访问权限分配到 |
服务主体 |
| 成员 |
DevOps基础设施 |
为每个池使用多个映像，并使用别名区分
如果池中有多个映像，可以通过引用特定映像的别名来将 Azure DevOps 管道配置为使用该映像。
如果你的池中有多个映像，并且不在管道中使用需求来指定映像，那么管道将使用池中第一个列出的映像运行。 可以通过更改images部分中的fabricProfile列表中的图像顺序（如果使用模板），或者在 Azure 门户中使用拖放功能对映像列表中的图像进行排序来调整池中的图像顺序。
提示
如果首次向池添加新映像后，管道出现问题，请检查列表中的映像顺序，并考虑使用需求和别名显式指定每个管道要使用的映像。
若要添加和管理映像别名，请转到池设置的 “映像 ”部分，然后选择 ...， 添加别名。
将任何所需别名添加到 别名 列表，然后选择“ 保存”。
以下示例显示了一个池，其中包含两个 Azure Pipelines 映像和一个选定的市场映像。 Azure Pipeline 映像显示其默认别名，所选市场映像具有名为 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"
]
}
]
若要配置别名，请在 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"
]
}
]
若要配置别名，请在 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-gen2 别名的上一个示例中的 Ubuntu 24.04 映像上运行管道，请在管道部分指定以下需求 pool 。
pool:
name: fabrikam-dev-pool # Name of Managed DevOps Pool
demands:
- ImageOverride -equals ubuntu-24.04-gen2
重要
不要将别名的引号放在 ImageOverride 需求中，即使名称中有空格也是如此。
若要在池中使用 Azure Pipelines 映像运行管道，请使用上表中的别名。 若要在上一个示例中的 Azure Pipelines Windows Server 2022 映像上运行管道，请在管道的 pool 部分指定以下需求。
pool:
name: fabrikam-dev-pool # Name of Managed DevOps Pool
demands:
- ImageOverride -equals windows-2022
映像生命周期
当映像的操作系统达到其支持生命周期的末期时，托管 DevOps Pools 代理映像将会停用，而当基于新版本操作系统的映像发布时，基于旧版本操作系统的映像将会停用。
映像弃用计划
Azure Pipelines - Windows Server 2019 映像弃用计划
托管 DevOps 池正在删除 Azure Pipelines – Windows Server 2019 映像。
- 从 2025 年 11 月 1 日起，使用 Azure Pipelines – Windows Server 2019 创建新池将被禁用，但这些映像上的现有池将继续运行到 2025 年 12 月 31 日。
- 自 2025 年 12 月 31 日起，将停止支持使用 Azure Pipelines – Windows Server 2019 映像。 使用此映像的代理不会进行预配，并且管道不会运行。
若要在使用 Azure Pipelines – Windows Server 2019 映像时让托管 DevOps 池保持运行，请更新到 Azure Pipelines - Windows Server 2022 映像。 或者，可以使用选定的市场映像中的 Windows Server 2019 映像或自己的 Azure Compute Gallery Windows 2019 映像。 请注意，市场映像不包括在 Azure Pipelines 映像中找到的预安装软件。
Ubuntu 20.04 映像弃用计划
Ubuntu 20.04 LTS 标准支持已于 2025 年 5 月 31 日结束，托管 DevOps 池已从所选市场映像和 Azure Pipelines 映像中删除 Ubuntu 20.04 映像。
从 2025 年 7 月 15 日开始，禁用了使用 Ubuntu 20.04 所选市场映像或 Azure Pipelines 映像的新池。从 2025 年 8 月 30 日开始，此前配置为使用这些映像的管道将不再受支持。
若要保持当前使用 Ubuntu 20.04 运行的托管 DevOps 池，请将 Ubuntu 20.04 映像更新为 Ubuntu 22.04 或 24.04（建议）。 有关更多信息，请参阅选择池映像。 如果您的池中有多个 图像，请更新 Ubuntu 图像的 别名，以确保需要 Ubuntu 的管道能够使用所需的图像运行。
另请参阅
