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

[アーティクル]
11/05/2024

注意事項

この記事では、サービス終了 (EOL) 状態の Linux ディストリビューションである CentOS について説明します。適宜、使用と計画を検討してください。詳細については、「CentOS のサポート終了に関するガイダンス」を参照してください。

Azure Compute Gallery (旧称 Shared Image Gallery) を使用すると、組織全体でカスタムイメージを簡単に共有できます。カスタムイメージは Marketplace のイメージに似ていますが、カスタムイメージは自分で作成します。イメージは、VM、VHD、スナップショット、マネージドイメージ、別のイメージバージョンから作成できます。

Azure Compute Gallery を使うと、組織内、リージョン内またはリージョン間、Microsoft Entra テナント内、またはコミュニティギャラリーを使ってパブリックで、他のユーザーとカスタム VM イメージを共有できます。どのイメージを共有するか、どのリージョンでそのイメージを使用できるようにするか、および、だれと共有するかを選択することができます。イメージを論理的にグループ化するために、複数のギャラリーを作成できます。 ARM64、Accelerated Networking、TrustedVM などの多くの新機能は、Azure Compute Gallery でのみサポートされていて、マネージドイメージでは使用できません。

Azure Compute Gallery 機能には、次のような複数のリソースの種類があります。

リソース	説明
イメージのソース	これは、ギャラリーにイメージバージョンを作成するために使用できるリソースです。イメージのソースには、一般化または特殊化された既存の Azure VM、マネージドイメージ、スナップショット、または別のギャラリー内のイメージバージョンを使用できます。
[ギャラリー]	Azure Marketplace と同様に、ギャラリーは、イメージと VM アプリケーションを管理して共有するためのリポジトリです。ただし、だれがアクセスできるかは、ユーザーが制御します。
イメージ定義	イメージ定義はギャラリー内に作成され、内部で使用するためにイメージと要件に関する情報を伝達します。この情報には、イメージが Windows または Linux のどちらか、リリースノート、および最小と最大のメモリ要件が含まれます。これは、イメージの種類の定義です。
イメージバージョン	イメージバージョンは、ギャラリーを利用している場合に、VM の作成に使用します。お使いの環境に必要な複数のイメージバージョンを保持できます。マネージドイメージのように、イメージバージョンを使用して VM を作成する場合、イメージバージョンは VM 用の新しいディスクを作成するために使用されます。イメージバージョンは複数回、使用できます。

開始する前に

この記事を完了するには、Azure Compute Gallery が既に存在し、イメージのソースが Azure で使用可能である必要があります。イメージソースは、次のものとすることができます。

サブスクリプション内の VM。特殊な VM と一般の VM の両方からイメージをキャプチャできます。
マネージドイメージ
マネージド OS ディスクとデータディスク。
ストレージアカウント内の VHD としての OS ディスクとデータディスク。
同じギャラリー内、または同じサブスクリプションの別のギャラリー内の他のイメージバージョン。

イメージにデータディスクが含まれる場合、データディスクのサイズは 1 TB を超えることはできません。

イメージ定義名は、大文字または小文字、数字、ドット、ダッシュおよびピリオドで構成できます。イメージ定義に指定できる値の詳細については、イメージ定義に関するページを参照してください。

イメージバージョンで許可されている文字は、数字とピリオドです。数字は、32 ビット整数の範囲内になっている必要があります。形式:MajorVersion.MinorVersion.Patch。

この記事の作業に出現するリソース名は適宜置き換えてください。

一般化されたイメージについては、イメージをキャプチャする前に OS 固有のガイダンスを参照してください。

Linux
- 一般的な手順
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

初めて VHD を Azure に仮想ハードディスク (VHD) にアップロードする前に Sysprep を実行する予定の場合は、VM の準備ができていることを確認してください。

コミュニティギャラリー

コミュニティギャラリーを使ってイメージを共有する場合は、ギャラリー、イメージ定義、イメージバージョンを同じリージョンに作成してください。

ユーザーがコミュニティギャラリーイメージを検索すると、最新バージョンのイメージのみが表示されます。

重要

イメージの定義の情報、たとえば [発行]、[プラン]、[SKU] に指定した情報がパブリックに公開されます。

イメージを作成する

イメージ定義とイメージバージョンを作成するには、次のオプションを選択します。

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

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

Azure portal に移動し、Azure Compute Gallery を検索して選択します。
一覧から使うギャラリーを選びます。
ギャラリーのページで、ページの上部にある [追加] を選択し、ドロップダウンから [VM image definition](VM イメージ定義) を選択します。
[Add new image definition to Azure Compute Gallery](Azure Compute Gallery に新しいイメージ定義を追加) ページの [基本] タブで [リージョン] を選択します。
[イメージの定義名] で、「myImageDefinition」などの名前を入力します。
[オペレーティングシステム] では、ソースに基づいて適切なオプションを選択します。
[VM の生成] では、ソースに基づいてオプションを選択します。ほとんどの場合、これは [Gen 1] になります。詳細については、第 2 世代 VM に対するサポートに関するページを参照してください。
[オペレーティングシステムの状態] では、ソースに基づいて適切なオプションを選択します。詳細については、一般化と特殊化に関するページを参照してください。
[Publisher](発行元) に、一意の名前を入力します (myPublisher など)。
[オファー] に、一意の名前を入力します (myOfferなど)。
[SKU] に、一意の名前を入力します (mySKUなど)。
ページの下部で [確認および作成] を選択します。
イメージ定義の検証に合格した後、 [作成] を選択します。
デプロイが完了したら、 [リソースに移動] を選択します。
イメージ定義のページの [Get started](作業の開始) タブから [Create a version](バージョンの作成) を選択します。
[リージョン] でイメージを作成するリージョンを選択します。場合によっては、ソースはイメージが作成されるのと同じリージョンに存在する必要があります。後のドロップダウンリストにソースが表示されない場合は、イメージのリージョンを変更してみてください。イメージは、後でいつでも他のリージョンにレプリケートできます。
[バージョン番号] には、「1.0.0」のような数値を入力します。イメージバージョン名では、整数を使用する major.minor.patch という形式に従う必要があります。

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

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

[最新から除外] は、既定値の [いいえ] のままにします (ただし、バージョン番号の代わりに latest を使用して VM を作成するときにこのバージョンを使用したくない場合を除きます)。
[有効期限の終了日] で、このバージョンの使用の停止を検討している日付をカレンダーから選択します。
[レプリケーション] タブで、ドロップダウンからストレージの種類を選択します。
[既定のレプリカ数] を設定すると、追加するリージョンごとにこれをオーバーライドできます。
ソースリージョンにレプリケートする必要があります。そのため、一覧の最初のレプリカは、イメージを作成したリージョンになります。レプリカをさらに追加するには、ドロップダウンからリージョンを選択し、必要に応じてレプリカ数を調整します。
完了したら、 [確認および作成] を選択します。 Azure で構成が検証されます。
イメージバージョンの検証に合格したら、 [作成] を選択します。
デプロイが完了したら、 [リソースに移動] を選択します。

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

ポータルから既存の 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

Note

サードパーティの Marketplace イメージに由来するイメージを含むイメージ定義の場合、プラン情報は、サードパーティイメージのプラン情報と正確に一致している必要があります。イメージ定義にプラン情報を含めるには、イメージ定義を作成するときに、--plan-name、--plan-product、--plan-publisher を追加します。

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

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

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

source	パラメーターセット
OS ディスク:
VM ID を使用する VM	`--managed-image <Resource ID of the VM>`
マネージドイメージまたは別のイメージバージョン	`--managed-image <Resource ID of the managed image or image version`
スナップショットまたはマネージドディスク	`--os-snapshot <Resource ID of the snapshot or managed disk>`
ストレージアカウント内の VHD	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`
データディスク:
スナップショットまたはマネージドディスク	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
ストレージアカウント内の VHD	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

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

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

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

この例の --managed-image の値を、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 \
   --managed-image "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Note

同じマネージドイメージを使用して別のイメージバージョンを作成する前に、そのイメージバージョンが構築とレプリケーションを完全に完了するまで待つ必要があります。

また、イメージバージョンを作成するときに、--storage-account-type premium_lrs を追加してイメージを Premium ストレージに格納することも、--storage-account-type standard_zrs を追加して--storage-account-type premium_lrsに格納することもできます。

イメージ定義では、イメージの論理グループを作成します。イメージ定義を作成する際は、正しい情報がすべて含まれていることを確認してください。ソース 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'

Note

サードパーティイメージに由来するイメージを含むイメージ定義の場合、プラン情報は、サードパーティイメージのプラン情報と正確に一致している必要があります。イメージ定義にプラン情報を含めるには、イメージ定義を作成するときに、-PurchasePlanName、-PurchasePlanProduct、-PurchasePlanPublisher を追加します。

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

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

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

source	パラメーターセット
OS ディスク
VM ID を使用する VM	`-SourceImageId <Resource ID of the VM>`
マネージドイメージまたは別のイメージバージョン	`-SourceImageId <Resource ID of the managed image or image version`
スナップショットまたはマネージドディスク	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
データディスク
スナップショットまたはマネージドディスク	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

次の例では、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

Note

また、イメージバージョンを作成するときに、-StorageAccountType Premium_LRS を追加してイメージを Premium ストレージに格納することも、-StorageAccountType Standard_ZRS を追加して-StorageAccountType Premium_LRSに格納することもできます。

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

あるテナントに別のテナントのソースイメージを使用してイメージを作成する

ソースイメージが存在するサブスクリプションで、ユーザーに閲覧者のアクセス許可を付与します。ユーザーは、ソースイメージに対する閲覧者アクセス許可を得たら、両方のアカウント (ソースとターゲット) にログインします。

ソースイメージの tenantID、新しいイメージを保存するサブスクリプションの subscriptionID (ターゲット)、ソースイメージの resourceID が必要です。さらに、ソースイメージのリージョンまたはレプリカとターゲットリージョンが同じであることを確認する必要があります。

CLI
PowerShell

# 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

次のステップ

購入プラン情報を提供する方法については、イメージ作成時の Azure Marketplace 購入プラン情報の提供に関する記事を参照してください。

次の方法で共有

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

開始する前に

コミュニティギャラリー

イメージを作成する

あるテナントに別のテナントのソースイメージを使用してイメージを作成する

次のステップ

フィードバック

その他のリソース

次の方法で共有

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

開始する前に

コミュニティ ギャラリー

イメージを作成する

あるテナントに別のテナントのソース イメージを使用してイメージを作成する

次のステップ

フィードバック

その他のリソース

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

コミュニティギャラリー

あるテナントに別のテナントのソースイメージを使用してイメージを作成する