マネージド DevOps プール イメージを設定する

Managed DevOps プールを作成するときに、既定のイメージが選択されます。 既定の選択肢をそのまま使用することも、プールの作成時に変更することもできます。 プールの作成後にイメージを構成するには、 設定>Pool に移動します。 [イメージ ライブラリから追加] を選択し、プールの 1 つ以上のイメージを選択します。

Managed DevOps Pools リソース プロパティの fabricProfile セクションでイメージを構成できます。

次の例では、3 つの画像を指定します。 イメージのスキーマの詳細については、この記事の以下のセクションを参照してください。

{
    "$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"
                        }
                    ]
                }
            }
        }
    ]
}

各イメージには、次のプロパティを含めることができます。

次の例では、3 つの画像を定義します。 スタンバイ エージェントが有効になり、スタンバイ エージェントの 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"
    }
]

Managed DevOps Pools リソース プロパティの fabric-profile セクションでイメージを構成できます。

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

次の例は、images ファイルの fabric-profile.json セクションを示し、3 つの画像を指定します。 イメージのスキーマの詳細については、この記事の以下のセクションを参照してください。

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

各イメージには、次のプロパティを含めることができます。

次の例では、3 つの画像を定義します。 スタンバイ エージェントが有効になり、スタンバイ エージェントの 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": {...}
  }
}

Managed DevOps Pools リソース プロパティの fabricProfile セクションでイメージを構成できます。

次の例では、3 つの画像を指定します。 イメージのスキーマの詳細については、この記事の以下のセクションを参照してください。

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'
        }
      ]
    }
  }
}

各イメージには、次のプロパティを含めることができます。

次の例では、3 つの画像を定義します。 スタンバイ エージェントが有効になり、スタンバイ エージェントの 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'
  }
]

Azure Pipelines イメージを指定するには、一覧から選択します。

Azure portal を使用して 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"
    }
]

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"
    }
]

選択したマーケットプレース イメージを指定するには、 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 コンピューティング ギャラリー イメージを指定するには、 resourceId プロパティを使用してイメージのリソース ID を指定します。

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

イメージ エイリアスを追加および管理するには、プール設定の [イメージ] セクションに移動し、...> を選択します。エイリアスを追加します。

必要なエイリアスを [エイリアス ] ボックスの一覧に追加し、[保存] を選択 します。

次の例は、2 つの Azure Pipelines イメージと 1 つの選択したマーケットプレース イメージを含むプールを示しています。 Azure Pipeline イメージには既定のエイリアスが表示され、選択した Marketplace イメージには ubuntu-24.04-gen2 という名前の 1 つの構成済みのエイリアスが表示されます。

エイリアスを構成するには、 aliases の一覧でエイリアスを指定します。 次の例では、 ubuntu-24.04-gen2という名前の 1 つのエイリアスを持つ 1 つのイメージを定義します。

"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という名前の 1 つのエイリアスを持つ 1 つのイメージを定義します。

"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という名前の 1 つのエイリアスを持つ 1 つのイメージを定義します。

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'
    ]
  }
]