配置托管 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"
                        }
                    ]
                }
            }
        }
    ]
}

每个图像可以具有以下属性。

以下示例定义三个图像。 已启用备用代理，其中 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 文件的节，并指定三个图像。 有关映像架构的详细信息，请参阅本文中的以下部分。

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

使用 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 则使用。

选择 “所选市场映像”，选择所需的映像，然后选择所需的版本。 选择 最新版本 以始终使用最新版本的映像。

若要指定选定的市场映像，请使用 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 计算库映像，请使用该 resourceId 属性提供映像的资源 ID。

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

若要指定 Azure 计算库映像，请使用该 resourceId 属性提供映像的资源 ID。

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

若要添加和管理映像别名，请转到池设置的 “映像 ”部分，然后选择 ...， 添加别名。

将任何所需别名添加到 别名 列表，然后选择“ 保存”。

以下示例显示了一个池，其中包含两个 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"
        ]
    }
]