イメージ定義とイメージ バージョンを作成する

ポータルで VM からイメージを作成するには、VM のイメージのキャプチャに関するページを参照してください。

VM 以外のソースを使用してイメージを作成するには、次の手順に従います。

1. Azure portal に移動し、Azure Compute Gallery を検索して選択します。

2. 一覧から使うギャラリーを選びます。

3. ギャラリーのページで、ページの上部にある [追加] を選択し、ドロップダウンから [VM image definition](VM イメージ定義) を選択します。

4. [Add new image definition to Azure Compute Gallery](Azure Compute Gallery に新しいイメージ定義を追加) ページの [基本] タブで [リージョン] を選択します。

5. [イメージの定義名] で、「myImageDefinition」などの名前を入力します。

6. [オペレーティング システム] では、ソースに基づいて適切なオプションを選択します。

7. [VM の生成] では、ソースに基づいてオプションを選択します。 ほとんどの場合、これは [Gen 1] になります。 詳細については、第 2 世代 VM に対するサポートに関するページを参照してください。

8. [オペレーティング システムの状態] では、ソースに基づいて適切なオプションを選択します。 詳細については、一般化と特殊化に関するページを参照してください。

9. [Publisher](発行元) に、一意の名前を入力します (myPublisher など)。

10. [オファー] に、一意の名前を入力します (myOfferなど)。

11. [SKU] に、一意の名前を入力します (mySKUなど)。

12. ページの下部で [確認および作成] を選択します。

13. イメージ定義の検証に合格した後、 [作成] を選択します。

14. デプロイが完了したら、 [リソースに移動] を選択します。

15. イメージ定義のページの [Get started](作業の開始) タブから [Create a version](バージョンの作成) を選択します。

16. [リージョン] でイメージを作成するリージョンを選択します。 場合によっては、ソースはイメージが作成されるのと同じリージョンに存在する必要があります。 後のドロップダウン リストにソースが表示されない場合は、イメージのリージョンを変更してみてください。 イメージは、後でいつでも他のリージョンにレプリケートできます。

17. [バージョン番号] には、「1.0.0」のような数値を入力します。 イメージ バージョン名では、整数を使用する major.minor.patch という形式に従う必要があります。

18. [ソース] で、ソースに使用するファイルの種類をドロップダウンから選択します。 各種類のソースの具体的な詳細については、次の表を参照してください。

    ソース	その他のフィールド
    ディスクまたはスナップショット	- OS ディスクの場合、ドロップダウンからディスクまたはスナップショットを選択します。 - データ ディスクを追加するには、LUN 番号を入力し、ドロップダウンからデータ ディスクを選択します。
    イメージ バージョン	- ドロップダウンからソース ギャラリーを選択します。 - ドロップダウンから正しいイメージ定義を選択します。 - ドロップダウンから、使用する既存のイメージ バージョンを選択します。
    マネージド イメージ	\- ドロップダウンからソース イメージを選択します。 マネージド イメージは、 [インスタンスの詳細] で選択したのと同じリージョンにある必要があります。
    ストレージ アカウント内の VHD	[参照] を選択して、VHD のストレージ アカウントを選択します。

19. [最新から除外] は、既定値の [いいえ] のままにします (ただし、バージョン番号の代わりに latest を使用して VM を作成するときにこのバージョンを使用したくない場合を除きます)。

20. [有効期限の終了日] で、このバージョンの使用の停止を検討している日付をカレンダーから選択します。

21. [レプリケーション] タブで、ドロップダウンからストレージの種類を選択します。

22. [既定のレプリカ数] を設定すると、追加するリージョンごとにこれをオーバーライドできます。

23. ソース リージョンにレプリケートする必要があります。そのため、一覧の最初のレプリカは、イメージを作成したリージョンになります。 レプリカをさらに追加するには、ドロップダウンからリージョンを選択し、必要に応じてレプリカ数を調整します。

24. 完了したら、 [確認および作成] を選択します。 Azure で構成が検証されます。

25. イメージ バージョンの検証に合格したら、 [作成] を選択します。

26. デプロイが完了したら、 [リソースに移動] を選択します。

イメージをすべてのターゲット リージョンにレプリケートするにはしばらく時間がかかる場合があります。

ポータルから既存の VM をイメージとしてキャプチャすることもできます。 詳細については、ポータルでの VM のイメージの作成に関するページを参照してください。

イメージ定義では、イメージの論理グループを作成します。 これは、その中に作成されるイメージ バージョンに関する情報を管理するために使用されます。

az sig image-definition create を使用して、ギャラリー内にイメージ定義を作成します。 イメージ定義の種類が適切であることを確認します。 (Linux の場合は waagent -deprovision、Windows の場合は Sysprep を使用して) VM を一般化している場合は、--os-state generalized を使用して、一般化されたイメージ定義を作成する必要があります。 既存のユーザー アカウントを削除せずに VM を使用する場合は、--os-state specialized を使用して、特殊化されたイメージ定義を作成します。

イメージ定義に指定できるパラメーターの詳細については、イメージ定義に関するページを参照してください。

この例では、イメージ定義は myImageDefinition という名前で、特殊化された Linux OS イメージ用です。 Windows OS を使用してイメージの定義を作成するには、--os-type Windows を使用します。

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

イメージ バージョンの作成

az sig image version create を使用してイメージ バージョンを作成します。

イメージを作成するための構文は、ソースとして使用する内容に応じて変わります。 OS ソースが 1 つしかない場合は、ソースの種類を混在させることができます。 また、データ ディスクごとに異なるソースを使用することもできます。

イメージにさまざまなソースを指定する方法の詳細な例については、az sig image-version create の例を参照してください。

次の例では、VM からイメージを作成します。 イメージのバージョンは 1.0.0 であり、ゾーン冗長ストレージを使用して "米国中西部" リージョンに 2 個のレプリカ、"米国中南部" リージョンに 1 個のレプリカ、および "米国東部 2" リージョンに 1 個のレプリカを作成しています。 レプリケーション リージョンには、ソース VM が配置されているリージョンが含まれている必要があります。

イメージを作成する前に VM を停止 (または割り当て解除) することをお勧めします。

この例の --virtual-machine の値を、VM の ID で置き換えます。

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

イメージ定義では、イメージの論理グループを作成します。 イメージ定義を作成する際は、正しい情報がすべて含まれていることを確認してください。 ソース VM を一般化した場合、-OsState generalized を利用してイメージ定義を作成する必要があります。 ソースを一般化していない場合、-OsState specialized を利用してイメージ定義を作成します。

イメージ定義に指定できる値の詳細については、イメージ定義に関するページを参照してください。

イメージの定義は、New-AzGalleryImageDefinition を使用して作成します。

この例では、イメージ定義は myImageDefinition という名前で、Windows を実行する特殊な VM 用です。 Linux を使用してイメージの定義を作成するには、-OsType Linux を使用します。

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

イメージ バージョンを作成する

New-AzGalleryImageVersion を使用してイメージ バージョンを作成します。

イメージを作成するための構文は、ソースとして使用する内容に応じて変わります。

次の例では、VM からイメージ バージョンを作成します。 Stop-AzVM を利用し、イメージを作成する前に VM を停止 (または割り当て解除) することをお勧めします。

この例のイメージ バージョンは 1.0.0 で、"米国中西部" と "米国中南部" の両方のデータセンターにレプリケートされます。 レプリケーションのターゲット リージョンを選択するときに、レプリケーションのターゲットとして、"ソース" リージョンも含める必要があることに注意してください。

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob 

すべてのターゲット リージョンにイメージがレプリケートされるまでにしばらく時間がかかることがあるため、進行状況を追跡できるようジョブを作成しました。 ジョブの進行状況を確認するには、「$job.State」と入力します。

$job.State

REST API を使用してイメージ定義を作成する

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

REST API を使用してイメージ バージョンを作成します。 この例では、VM からイメージ バージョンを作成します。 別のソースを使用するには、ソースのリソース ID を渡します (たとえば、OS ディスク スナップショットの ID を渡します)。

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

# Set some variables
tenantID="<tenant ID for the source image>"
subID="<subscription ID where the image will be creted>"
sourceImageID="<resource ID of the source image>"

# Login to the subscription where the new image will be created
az login

# Log in to the tenant where the source image is available
az login --tenant $tenantID

# Log back in to the subscription where the image will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID
   --location myLocation

# Set variables 
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID where for the source image>"
$sourceImageID = "<resource ID of the source image>"

# Login to the tenant where the source image is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication 

# Login to the subscription where the new image will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID 

# Create the image version from another image version in a different tenant
New-AzGalleryImageVersion `
   -ResourceGroupName myResourceGroup -GalleryName myGallery `
   -GalleryImageDefinitionName myImageDef `
   -Location "West US 2" `
   -Name 1.0.0 `
   -SourceImageId $sourceImageID