設定受控DevOps集區映像

受控 DevOps 集區提供數個虛擬機器（VM）映像選項，以在集區中執行管線。您可以使用選取的市集 VM 映像來建立集區、使用您自己的自定義 Azure Compute Gallery 映像，或使用與 Azure Pipelines Microsoft 裝載代理程式相同的映像。

重要

下列影像將在受控 DevOps 集區中淘汰：

Azure Pipelines - Windows Server 2019
Ubuntu 20.04

如需詳細資訊，請參閱受控 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-09-20",
            "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 Gallery 映像檔或特定市集映像檔時，這是必要的。
`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"
    }
]

您可以在受管理的 DevOps 集區資源屬性的fabric-profile 區段中設定映像檔。

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 映像或選取的市集映像時，這是必要的。
`wellKnownImageName`	Azure Pipelines 映射的別名。當您使用 Azure Pipelines 映像時，這是必要的。
`buffer`	當您啟用待命代理程式時，此 `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": {...}
  }
}

您可以在受管理的 DevOps 集區資源屬性的 fabricProfile 區段中設定映像。

下列範例會指定三個影像。如需映像架構的詳細資訊，請參閱本文中的下列各節。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  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 Gallery 映像或選取的市集映像時，這是必要的。
`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'
  }
]

如果您選取單一映像，集區中的所有管線都會使用該映像來執行。如果您選取多個影像檔，您可以為每個管道指定使用的影像檔。如需詳細資訊，請參閱每個集區使用多個映像。

如果您的集區中有多個映像，而且未使用管線中的需求來指定映像，管線會使用集區中第一個列出的映像來執行。您可以透過下列兩種方式變更影像池中影像的順序：

使用模板：更改fabricProfile部分中的images列表中圖像的順序。
使用拖曳：在 Azure 入口網站的影像清單中排序影像。

您可以從以下類型的影像中進行選擇：

Azure Pipelines 映像：從 Microsoft 裝載代理程式使用的相同映像中選取。
選取的市集映像：從一組精選的 Microsoft 發佈市集 VM 映像中選取。
Azure Compute Gallery 映像：從您自己的 Azure Compute Gallery 映像中選取。您必須將 讀取者 角色指派給 DevOpsInfrastructure 您要使用的 Azure Compute Gallery 映像的服務主體。如需詳細資訊，請參閱授與服務主體的 DevOpsInfrastructure 讀者角色存取權。

Azure Pipelines 映射

受控DevOps集區提供數個預先設定的映像，這些映像具有與 Azure Pipelines 所選Microsoft裝載代理程式相同的軟體。

受管理的 DevOps 集區中所提供的 Azure Pipelines 映像生命週期遵循 Microsoft 裝載代理程式映像的生命週期。如果 Microsoft 託管代理中的映像已被停止使用，則對應的 Managed DevOps Pools 映像也會在類似的時間範圍內被停止使用。 Microsoft裝載代理程式中可用的映像版本可能會與相同映射類型的 Managed DevOps 集區中可用的映射版本稍有不同。

如需受控 DevOps 集區映射生命週期的詳細資訊，請參閱映射生命週期。

當您使用 Azure 入口網站指定 Azure Pipelines 映像時，一律會使用最新版本的映像。

顯示 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 映像，請使用屬性 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 發佈的精選市集虛擬機器映像，供您在池中使用。

顯示所選市集映像的螢幕擷取畫面。

選擇 [選取的市集圖片]。選取所需的影像，然後選取所需的版本。若要一律使用最新版本的映像，請選取 [最新]。

若要指定選取的市集映像，請提供該映像的資源識別碼，並使用 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"
    }
]

若要指定選取的市集映像，請使用 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"
    }
]

若要指定選取的市集映像，請使用 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 計算資源庫映像，以從訂閱中任何可用的資源庫指定映像。支援具有下列作業系統的一般化映像：

Windows 伺服器 2025
Windows 伺服器 2022
Windows 11
Ubuntu 24.04
Ubuntu 22.04 版本
Debian 9
雷爾 9
雷爾 8
蘇斯15
蘇斯12

重要

受控DevOps集區僅支援一般化的 Azure 計算資源庫映像。

受控 DevOps 集區不支援您使用付費基底映像建立的 Azure Compute Gallery 映像。如果您收到類似「不支援映像資料庫，因為它是付費映像」的錯誤信息。請提供免費的不同映像」，根據您使用基底映像的免費定價方案所建立的 VM 來選取不同的 Azure Compute Gallery 映像。

顯示 Azure Compute Gallery 映像的螢幕擷取畫面。

若要指定 Azure Compute Gallery 映像，請使用屬性 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"
    }
]

若要指定 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 Compute Gallery 映像的服務主體。如果您選取未設定此存取權的 Azure 計算資源庫映射，集區建立會失敗。您可以在影像的層級個別指派「讀者」角色，或在影像庫層級為圖片集中所有影像指派此角色。

移至 Azure 入口網站中所需的資源。若要使用庫中的所有映像，請移至 Azure 入口網站中的 Azure Compute Gallery。若要僅使用特定影像，請移至該影像。
選取 [存取控制 (IAM)]。
選取 [新增]> [新增角色指派]，開啟 [新增角色指派] 頁面。
指派下列角色。如需詳細步驟，請參閱使用 Azure 入口網站指派 Azure 角色。

設定值

角色讀取者

存取權指派對象服務主體

成員 DevOpsInfrastructure

設定	值
角色	讀取者
存取權指派對象	服務主體
成員	`DevOpsInfrastructure`

使用每個集區的多個映像搭配別名

如果您的集區中有多個映像，您可以參考該映像的別名，將 Azure DevOps 管線設定為使用特定映像。

如果您的集區中有多個映像，而且未使用管線中的需求來指定映像，管線會使用集區中第一個列出的映像來運行。您可以透過下列方式變更集區中影像的順序：

使用模板：更改fabricProfile部分中的images列表中圖像的順序。
使用拖曳：在 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 集區代理程式映像檔的作業系統達到其支援生命週期結束時，就會淘汰。當發行以新版本作業系統為基礎的映像檔時，以舊版作業系統為基礎的映像檔可能會淘汰。

Azure Pipelines 影像提供相同的影像，並遵循類似的淘汰排程，如同 Microsoft 裝載代理程式。
選取的市集映像通常在映像的作業系統到達支援生命周期結束時會被淘汰。

圖像逐步淘汰計畫

Azure Pipelines - Windows Server 2019 映像淘汰排程
Ubuntu 20.04 映像檔停用時程表

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 映像，以維持集區的運行，請更新至 Azure Pipelines - Windows Server 2022 映像。您也可以使用所選市集映像中的 Windows Server 2019 映像，或您自己的 Azure Compute Gallery Windows Server 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 的集區能夠繼續運行，請將 Ubuntu 20.04 映像檔更新為 Ubuntu 22.04 或 24.04（推薦）。如需詳細資訊，請參閱選取資源池的映像。如果您的集區中有多個映像，請更新您的 Ubuntu 映像的別名，以便管線能夠使用您所需的映像來執行 Ubuntu。

設定集區設定

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-11-18

共用方式為

設定受控DevOps集區映像

選擇您的資源池的影像

Azure Pipelines 映射

選取的市集映像

Azure 計算資源庫映像

授予 DevOpsInfrastructure 服務主體「讀者」角色的存取權限

使用每個集區的多個映像搭配別名

設定映像別名

Azure Pipelines 映像預先定義的別名

使用需求來指定影像

映射生命週期

圖像逐步淘汰計畫

Azure Pipelines - Windows Server 2019 映像檔棄用時間表

Ubuntu 20.04 映像檔停止支援時間表

相關內容

意見反應

其他資源