マネージドイメージを使用してカスタムイメージプールを作成する

[アーティクル]
03/18/2024

Batch プールの仮想マシン (VM) のカスタムイメージプールを作成するために、マネージドイメージを使用して Azure Compute Gallery イメージを作成できます。マネージドイメージだけを使用することもできますが、2019-08-01 以前の API バージョンでのみサポートされます。

警告

マネージドイメージを使用した Batch プールの作成のサポートは、2026 年 3 月 31 日以降に廃止されます。 Azure Compute Gallery でカスタムイメージをホストすることに移行してください。これは、Batch でカスタムイメージプールを作成するために使用します。詳細については、移行ガイドを参照してください。

このトピックでは、マネージドイメージだけを使用してカスタムイメージプールを作成する方法について説明します。

前提条件

マネージドイメージリソース。カスタムイメージを使用して仮想マシンのプールを作成するには、Batch アカウントと同じ Azure サブスクリプションおよびリージョンに、マネージドイメージリソースを配置または作成する必要があります。イメージは、VM のオペレーティングシステム (OS) ディスクと、それに接続されたデータディスク (後者はオプション) のスナップショットから作成する必要があります。
- 作成する各プールには、一意のカスタムイメージを使用します。
- Batch API を使用してイメージでプールを作成するには、イメージのリソース ID を指定します。形式は次のとおりです。/subscriptions/xxxx-xxxxxx-xxxxx-xxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myImage
- マネージドイメージリソースは、スケールアップするプールの有効期間を通じて存在する必要があり、プールを削除した後は削除することができます。
Microsoft Entra 認証。 Batch クライアント API では、Microsoft Entra 認証を使用する必要があります。 Microsoft Entra の Azure Batch のサポートについては、「Batch サービスの認証に Active Directory を使用する」に記載されています。

マネージドイメージを準備する

Azure では、次のものからマネージドイメージを準備できます。

Azure VM の OS とデータディスクのスナップショット
マネージドディスクで汎用化された Azure VM
クラウドにアップロードされた、汎用化されたオンプレミス VHD

マネージドイメージを使って Batch プールを安定的にスケーリングするには、最初の方法 (VM のディスクのスナップショットを使用する) のみを使用してマネージドイメージを作成することをお勧めします。次の手順では、VM を準備し、スナップショットを作成し、スナップショットからマネージドイメージを作成する方法を説明します。

VM を準備する

イメージ用に新しい VM を作成する場合、Batch によってサポートされているファーストパーティ Azure Marketplace イメージをマネージドイメージのベースイメージとして使用します。ファーストパーティのイメージのみを、基本イメージとして使用できます。 Azure Batch でサポートされている Azure Marketplace イメージ参照のフルリストを取得するには、サポートされているイメージの一覧に関する記事をご覧ください。

Note

基本イメージとして追加のライセンスと購入条件のあるサードパーティのイメージを使用することはできません。このような Marketplace イメージについては、Linux VM または Windows VM のガイダンスを参照してください。

サードパーティ製のイメージを使用するには、Azure コンピューティングギャラリーを使用できます。詳しくは、Azure Compute Gallery を使用してカスタムイメージプールを作成するを参照してください。

VM がマネージドディスクを使用して作成されていることを確認してください。これは VM を作成するときの既定のストレージ設定です。
VM には、Azure 拡張機能 (カスタムスクリプト拡張機能など) をインストールしないでください。イメージにプレインストールされた拡張機能が含まれる場合、Batch プールのデプロイ時に Azure で問題が発生する可能性があります。
添付データディスクを含める場合は、それらを使用する VM 内からディスクをマウントおよびフォーマットする必要があります。
提供するベース OS イメージには、必ず既定の一時ドライブを使用するようにしてください。現在、Batch ノードエージェントでは、既定の一時ドライブを使用する必要があります。
OS ディスクが暗号化されていないことを確認してください。
VM が実行状態になったら、RDP (Windows の場合) または SSH (Linux の場合) を使用して VM に接続します。必要なソフトウェアをインストールしたり、必要なデータをコピーしてください。

VM スナップショットを作成する

スナップショットは、VHD の完全な読み取り専用コピーです。 VM の OS やデータディスクのスナップショットを作成するには、Azure portal またはコマンドラインツールを使用できます。スナップショットを作成するための手順とオプションについては、VM のガイダンスをご覧ください。

1 つ以上のスナップショットからイメージを作成する

スナップショットからマネージドイメージを作成するには、az image create コマンドなどの Azure コマンドラインツールを使用します。イメージを作成する際には、OS ディスクのスナップショットを指定し、必要に応じて 1 つ以上のデータディスクスナップショットを指定することができます。

マネージドイメージからプールを作成する

マネージドイメージのリソース ID が見つかったら、そのイメージからカスタムイメージプールを作成します。次の手順では、Batch サービスまたは Batch Management を使用してカスタムイメージプールを作成する方法を説明します。

Note

Microsoft Entra 認証に使用する ID に、イメージリソースに対するアクセス許可があることを確認してください。「Batch サービスの認証に Active Directory を使用する」を参照してください。

マネージドイメージのリソースは、プールの有効期間にわたって存在する必要があります。基になるリソースが削除されると、プールはスケールできません。

Batch サービス .NET SDK

private static VirtualMachineConfiguration CreateVirtualMachineConfiguration(ImageReference imageReference)
{
    return new VirtualMachineConfiguration(
        imageReference: imageReference,
        nodeAgentSkuId: "batch.node.windows amd64");
}

private static ImageReference CreateImageReference()
{
    return new ImageReference(
        virtualMachineImageId: "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image definition name}");
}

private static void CreateBatchPool(BatchClient batchClient, VirtualMachineConfiguration vmConfiguration)
{
    try
    {
        CloudPool pool = batchClient.PoolOperations.CreatePool(
            poolId: PoolId,
            targetDedicatedComputeNodes: PoolNodeCount,
            virtualMachineSize: PoolVMSize,
            virtualMachineConfiguration: vmConfiguration);

        pool.Commit();
    }

Batch Management REST API

REST API URI

 PUT https://management.azure.com/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Batch/batchAccounts/{account name}/pools/{pool name}?api-version=2020-03-01

要求本文

 {
   "properties": {
     "vmSize": "{VM size}",
     "deploymentConfiguration": {
       "virtualMachineConfiguration": {
         "imageReference": {
           "id": "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image name}"
         },
         "nodeAgentSkuId": "{Node Agent SKU ID}"
       }
     }
   }
 }

サイズの大きなプールに関する考慮事項

カスタムイメージを使用して数百個以上の VM を含むプールを作成する場合、前述のガイダンスに従い、VM スナップショットから作成されたイメージを使用することが重要です。

次の考慮事項にも注意してください。

サイズ制限 - Batch では、カスタムイメージを使用する場合、2500 個の専用コンピューティングノードか、1000 個のスポットノードにプールサイズが制限されます。

同じイメージ (または同じスナップショットに基づく複数のイメージ) を使用して複数のプールを作成する場合は、プール内のコンピューティングノードの合計数が、上記の制限を超えないようにする必要があります。 1 つのイメージや基盤スナップショットを、複数のプールに使用することは推奨されません。

制限は、受信 NAT プールを使ってプールを構成することで緩和される場合があります。
サイズ変更のタイムアウト - プールに固定数のノードが含まれている (自動スケールではない) 場合は、プールの resizeTimeout プロパティの値を 20 ～ 30 分に増やしてください。タイムアウト時間内にプールがターゲットサイズに達しなかった場合は、別のサイズ変更操作を実行してください。

プールに 300 個以上のコンピューティングノードを含める場合は、ターゲットサイズに達するまでに、プールのサイズを複数回変更しなければならない場合あります。

Azure Compute Gallery を使用すると、カスタマイズしたイメージを使用してより大きなプールを作成でき、それと共により多くの共有イメージレプリカを作成できます。これには、ノードの準備が整うまでの時間の短縮など、パフォーマンスが向上するという利点が伴います。

Packer の使用に関する注意点

ユーザーサブスクリプションモードの Batch アカウントがある場合のみ、マネージドイメージリソースをPacker で直接作成できます。 Batch サービスモードのアカウントでは、最初に VHD を作成し、次にマネージドイメージリソースへ VHD をインポートする必要があります。マネージドイメージリソースを作成する手順は、プール割り当てモード (ユーザーのサブスクリプションまたは Batch サービス) によって異なります。

カスタムイメージを参照するすべてのプールの有効期間用に、マネージドイメージを作成するために使用するリソースが存在することを確認します。これに失敗すると、プールの割り当てやサイズ変更に失敗する可能性があります。

イメージまたは基になるリソースが削除された場合は、There was an error encountered while performing the last resize on the pool. Please try resizing the pool again. Code: AllocationFailed に似たエラーが発生します。このようなエラーが発生した場合、基になるリソースが削除されていないことを確認します。

Packer を使用して VM を作成する詳細については、「Build a Linux image with Packer」 (Packer で Linux イメージを作成) または「Build a Windows image with Packer」 (Packer で Windows イメージを作成) を参照してください。

次のステップ

Azure Compute Gallery を使用してカスタムプールを作成する方法を学習してください。
Batch の詳細については、「Batch サービスのワークフローとリソース」を参照してください。

マネージド イメージを使用してカスタム イメージ プールを作成する