マネージド DevOps プール イメージを構成する

Managed DevOps プールを作成するときに、既定のイメージが選択されます。 既定の選択肢をそのまま使用することも、プールの作成時に変更することもできます。 プールの作成後にイメージを構成するには、 Settings>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": "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"
                        }
                    ]
                }
            }
        }
    ]
}

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

次の例では、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 ファイルの セクションを示し、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": {...}
  }
}

Azure portal を使用して 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 が使用されます。

選択した Marketplace イメージ、目的のイメージを選択して、目的のバージョンを選択します。 常に最新バージョンのイメージを使用するには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"
    }
]

選択した Marketplace イメージを指定するには、 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"
    }
]

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

必要なエイリアスを Alias リストに追加し、 Save を選択します。

次の例は、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"
        ]
    }
]