カスタムイメージの作成、削除、使用中止

ソースディスク、イメージ、スナップショット、Cloud Storage に保存されているイメージからカスタムイメージを作成できます。これらのイメージを使用して、新しい仮想マシン（VM）インスタンスを作成できます。これは、永続ブートディスクまたは特定のイメージを作成して特定の状態に変更し、その状態を保存してインスタンスを作成する場合に理想的です。

あるいは、仮想ディスクインポートツールを使用して、既存のシステムから Compute Engine にブートディスクイメージをインポートし、それらのイメージをカスタムイメージリストに追加することもできます。

始める前に

このガイドのコマンドラインのサンプルを使用する場合、以下を行ってください。
1. gcloud コマンドラインツールの最新バージョンをインストールするか、最新バージョンに更新します。
2. デフォルトのリージョンとゾーンを設定します。
このガイドの API の例を使用する場合は API アクセスを設定します。
イメージのページを参照してください。

カスタムイメージの作成

ここでは、Linux インスタンスでカスタムイメージを作成する方法を説明します。Windows イメージの作成手順については、Windows イメージを作成するを参照してください。

イメージを他のプロジェクトと共有するには、Cloud Identity and Access Management（Cloud IAM）権限を使用する必要があります。

イメージの保存ロケーションの選択

カスタムイメージを作成する場合、イメージの Cloud Storage のロケーションを指定できます。ただし、デュアルリージョンのロケーションを除きます。イメージの保存ロケーションを指定すると、リージョン全体の冗長性を確保することで、データの局所性に関する規制およびコンプライアンスの要件と、高可用性のニーズを満たすことができます。

保存ロケーション機能はオプションです。ロケーションを選択しない場合、Compute Engine はイメージソースに最も近いマルチリージョンにイメージを保存します。

現在イメージが保存されている場所を確認するには、gcloud compute から images describe コマンドを使用します。

gcloud compute images describe [IMAGE_NAME] --project [PROJECT]

⋮
storageLocations:
- us-central1

この機能のリリース前の既存のイメージはすべて、元のロケーションに残ります。唯一の変更点は、すべてのイメージについてイメージのロケーションを表示できることです。移動する既存のイメージがある場合、目的のロケーションに再作成する必要があります。

イメージに対するインスタンスの準備

実行中の VM インスタンスに接続されている状態のディスクからでもイメージを作成できます。ただし、イメージをキャプチャしやすい状態にインスタンスを調整することで、イメージの信頼性が向上します。次のいずれかの手順でブートディスクをイメージ用に準備します。

インスタンスを停止してシャットダウンできるようにし、永続ディスクへのデータの書き込みを停止します。
イメージを作成する前にインスタンスを停止できない場合は、ディスクへの書き込み量を最小限に抑え、ファイルシステムを同期してください。
1. 永続ディスクにデータを書き込むアプリやオペレーティングシステムのプロセスを一時停止します。
2. 必要に応じて、アプリでディスクへのフラッシュを実行します。たとえば、MySQL では FLUSH ステートメントを使用します。他のアプリにも同様のプロセスがある場合があります。
3. アプリの永続ディスクへの書き込みを停止します。
4. sudo sync を実行します。

インスタンスの準備が完了したら、イメージを作成します。

イメージを作成する

次のソースからディスクイメージを作成できます。

永続ディスク。ディスクがインスタンスに接続されていても構いません
永続ディスクのスナップショット
プロジェクトの別のイメージ
別のプロジェクトで共有されているイメージ
Cloud Storage 内の圧縮された RAW イメージ

Console

Google Cloud Console で、[イメージの作成] ページに移動します。
[イメージの作成] ページに移動
イメージの [名前] を指定します。
イメージ作成元の [ソース] を指定します。永続ディスク、スナップショット、別のイメージまたは Cloud Storage 内の disk.raw ファイルが指定できます
イメージを保存するロケーションを指定します。[ソースディスクのロケーションに基づく（デフォルト）] プルダウンリストからイメージの保存ロケーションを選択します。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。
イメージのプロパティを指定します。たとえば、イメージのイメージファミリー名を指定して、このイメージをイメージファミリーの一部として管理できます。
[作成] をクリックして、イメージを作成します。

gcloud

gcloud コマンドラインツールで、gcloud compute images create コマンドを使用してカスタムイメージを作成します。

ソースディスクからイメージを作成:

gcloud compute images create [IMAGE_NAME] \
  --source-disk [SOURCE_DISK] \
  --source-disk-zone [ZONE] \
  --family [IMAGE_FAMILY] \
  --storage-location [LOCATION] \
  --force

ここで

[IMAGE_NAME] は、新しいイメージの名前です。
[SOURCE_DISK] は、イメージの作成元のディスクです。
[ZONE] は、ディスクが配置されているゾーンです。
[IMAGE_FAMILY] は、このイメージが属するイメージファミリーを指定するオプションのフラグです。
[LOCATION] は、イメージを保存するリージョンかマルチリージョンを指定できるオプションのフラグです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。
[--force] は、実行中のインスタンスからイメージを作成するためのオプションのフラグです。デフォルトでは、実行中のインスタンスからイメージを作成することはできません。このフラグは、インスタンスの実行中にイメージを作成することを確実に意図している場合にのみ指定してください。

ソースイメージからイメージを作成:

gcloud compute images create [IMAGE_NAME] \
  --source-image [SOURCE_IMAGE] \
  --source-image-project [IMAGE_PROJECT] \
  --family [IMAGE_FAMILY] \
  --storage-location [LOCATION]

ここで

[IMAGE_NAME] は、新しいイメージの名前です。
[SOURCE_IMAGE] は、新しいイメージの作成元となるイメージです。
[IMAGE_PROJECT] は、ソースイメージを配置するプロジェクトを指定するオプションのパラメータです。このパラメータは、別のプロジェクトからイメージをコピーする場合に使用します。
[IMAGE_FAMILY] は、この新しいイメージが属するイメージファミリーを指定するオプションのフラグです。
[LOCATION] は、イメージを保存するリージョンまたはマルチリージョンを指定できるオプションのフラグです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。

スナップショットからイメージを作成:

gcloud compute images create [IMAGE_NAME] \
  --source-snapshot [SOURCE_SNAPSHOT] \
  --storage-location [LOCATION]

ここで

[IMAGE_NAME] は、新しいイメージの名前です。
[SOURCE_SNAPSHOT] は、イメージの作成元となるスナップショットです。
[LOCATION] は、イメージを保存するリージョンまたはマルチリージョンを指定できるオプションのフラグです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。

イメージのロケーションの表示

gcloud compute images describe コマンドを使用して、イメージのロケーションを表示します。

gcloud compute images describe [IMAGE_NAME]

[IMAGE_NAME] は、説明するイメージの名前です。

API

images().insert メソッドに対して POST リクエストを実行します。リクエストの本文内の URL で、イメージの作成元となるソースオブジェクトをポイントします。独自のプロジェクト ID とイメージ名を使用して、リソースへの URL を指定します。

永続ディスクからイメージを作成:

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images

{
  "name": "[IMAGE_NAME]",
  "sourceDisk": "/zones/[ZONE]/disks/[SOURCE_DISK]",
  "storageLocations": "[LOCATION]",
  "forceCreate": "[FORCE_CREATE]"
}

ここで

[PROJECT_ID] は、イメージが属するプロジェクトです。
[IMAGE_NAME] は、作成する新しいイメージの名前です。
[ZONE] は、ソースディスクが配置されているゾーンです。
[SOURCE_DISK] は、イメージの作成元のディスクです。
[LOCATION] は、イメージの保存ロケーションを選択できるオプションのパラメータです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。
[FORCE_CREATE] は、実行中のインスタンスからイメージを作成するためのオプションのパラメータです。実行中のインスタンスからイメージを作成することを確実に意図している場合にのみ、TRUE を指定します。このパラメータを指定しない場合、デフォルト値は FALSE です。

別のイメージからイメージを作成:

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images

{
  "name": "[IMAGE_NAME]",
  "sourceImage": "/global/images/[SOURCE_IMAGE]",
  "storageLocations": "[LOCATION]"
}

ここで

[PROJECT_ID] は、イメージが属するプロジェクトです。
[IMAGE_NAME] は、作成する新しいイメージの名前です。
[SOURCE_IMAGE] は、イメージの作成元となるイメージです。
[LOCATION] は、イメージの保存ロケーションを選択できるオプションのパラメータです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。

スナップショットからイメージを作成:

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images
{
  "name": "[IMAGE_NAME]",
  "sourceSnapshot": "/[SOURCE_PROJECT_ID]/global/snapshots/[SOURCE_SNAPSHOT]",
  "storageLocations": "[LOCATION]"
}

ここで

[PROJECT_ID] は、イメージが属するプロジェクトです。
[IMAGE_NAME] は、作成する新しいイメージの名前です。
[SOURCE_SNAPSHOT] は、イメージの作成元となるスナップショットです。
[SOURCE_PROJECT_ID] は、スナップショットが配置されているプロジェクトを指定するオプションの変数です。そのプロジェクト内のスナップショットリソースにアクセスするには権限が必要です。
[LOCATION] は、イメージの保存ロケーションを選択できるオプションのパラメータです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。

イメージの追加に関する詳細については、イメージ参照をご覧ください。

イメージの使用を中止する

Compute Engine では、イメージに使用中止ステータスを設定することで、所有するカスタムイメージの使用を中止できます。使用中止ステータスごとに異なるレスポンスがサーバーから生成され、移行ユーザーがサポートされないイメージの使用を管理可能な方法で中止するのに役立ちます。コンソール、gcloud コマンド、Compute Engine API メソッドのいずれかを使用して、イメージの使用を中止します。

Console

Google Cloud Console で、[イメージの作成] ページに移動します。
[イメージの作成] ページに移動
使用を中止するイメージの左側にあるチェックボックスをオンにします。
ページ上部の [廃止] をクリックします。イメージの使用は中止されます。

gcloud

gcloud compute images deprecate コマンドを使用して、イメージの終了状態を設定します。

gcloud compute images deprecate [IMAGE_NAME] \
    --state [STATE] \
    --replacement [REPLACEMENT]

[IMAGE_NAME] には使用を中止するイメージの名前を指定します。

サポート終了状態は、次のいずれかになります。

DEPRECATED - このイメージは使用中止されたとみなされます。ユーザーがこのイメージを使用しようとすると、リクエストは成功しますが、Compute Engine によって警告も返されます。このイメージへの新しいリンクは依然として許可されます。イメージファミリーは、このイメージがファミリー内で最新のイメージであっても、このイメージをポイントしなくなります。
OBSOLETE - このイメージは廃止され、新しいユーザーはこれを使用できません。Compute Engine は、ユーザーがリクエストでこのイメージを使用しようとした場合にエラーを返します。このイメージへの既存のリンクは依然として許可されます。
DELETED - このイメージは削除され、ユーザーは使用できません。Compute Engine は、ユーザーがこのイメージを使用しようとした場合にエラーを返します。

API

images().deprecate メソッドに POST リクエストを送信します。使用を中止するイメージの名前を指定します。

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images/[RESOURCE_ID]/deprecate

{
  "deprecated": "[IMAGE_NAME]",
  "replacement": "[REPLACEMENT]"
}

ここで

[PROJECT_ID] は、イメージが属するプロジェクトです。
[IMAGE_NAME] は、使用を中止するイメージです。
[REPLACEMENT] は、使用を中止するイメージを置き換えるイメージです。

イメージを削除する

削除できるカスタムイメージは、プロジェクトへのアクセス権を持つ他のユーザーまたは自分が追加したカスタムイメージのみです。コンソール、gcloud コマンド、Compute Engine API メソッドのいずれかを使用して、イメージを削除します。

Console

Google Cloud Console で、[イメージの作成] ページに移動します。
[イメージの作成] ページに移動
削除するイメージの左側にあるチェックボックスをオンにします。
ページの上部にある [削除] をクリックします。イメージは削除されます。

gcloud

gcloud compute images delete コマンドを使用して、イメージを削除します。

gcloud compute images delete [IMAGE_NAME]

[IMAGE_NAME] には削除するイメージの名前を指定します。

API

images().delete メソッドに POST リクエストを送信します。削除するイメージの名前を指定します。

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images/[RESOURCE_ID]

ここで

[PROJECT_ID] は、イメージが属するプロジェクトです。
[RESOURCE_ID] は、削除するイメージの名前です。

イメージファミリー内のイメージのバージョンを設定する

イメージファミリーを使用して、イメージのバージョン管理を簡略化します。イメージをイメージファミリーに追加し、最新のイメージバージョンとして設定します。イメージファミリーを以前のイメージバージョンにロールバックする必要があると判断した場合は、ファミリー内の最新のイメージの使用を中止します。

コンソール、gcloud compute images create コマンドと --storageLocation フラグ、または images().insert API メソッドを使用して、イメージの保存ロケーションを指定することもできます。

たとえば、イメージファミリーの一部として image-v1 という名前のイメージを作成します。

Console

Google Cloud Console で、[イメージの作成] ページに移動します。
[イメージの作成] ページに移動
イメージの [名前] を指定します。
イメージ作成元の [ソース] を指定します。永続ディスク、スナップショット、別のイメージまたは Google Cloud Storage 内の disk.raw ファイルが指定できます
イメージを保存する [ロケーション] を指定します。[ソースディスクのロケーションに基づく（デフォルト）] プルダウンメニューからイメージの保存ロケーションを選択します。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。
イメージのプロパティを指定します。たとえば、イメージのイメージファミリー名 my-image-family を指定して、このイメージをイメージファミリーの一部として管理できます。
実行中のイメージに接続されたディスクからイメージを作成する場合、[Force creation from running instance] をオンにして、インスタンスの実行中にイメージを作成することを確認します。
[作成] をクリックして、イメージを作成します。

gcloud

gcloud compute images create image-v1 \
    --source-disk disk-1 \
    --source-disk-zone us-central1-f \
    --family my-image-family \

イメージファミリーは image-v1 をポイントします。2 つ目のイメージをファミリーに追加します。

gcloud compute images create image-v2 \
    --source-disk disk-2 \
    --source-disk-zone us-central1-f \
    --family my-image-family \

API

images().insert メソッドに POST リクエストを送信します。リクエストの本文にイメージファミリーを指定します。

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images

{
  "name": "image-v2",
  "sourceDisk": "/zones/us-central1-f/disks/disk-2",
  "family":"my-image-family",

}

image-v2 はイメージファミリーに追加した最新のイメージであるため、イメージファミリーではこのイメージがポイントされます。

gcloud

gcloud compute images describe-from-family コマンドを実行して、ファミリーでどのイメージがポイントされるかを確認できます。

例:

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '8904691942610171306'
kind: compute#image
name: image-v2
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v2
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v2
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY

API

images().getFromFamily メソッドに GET リクエストを送信します。リクエストの本文にイメージファミリーを指定します。

GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images/family

{
  "resourceId":"my-image-family",

}

イメージファミリーをロールバックして image-v2 をポイントしなくなるようにする必要があると判断した場合は、を使用中止にすると、ファミリーは再び image-v1 をポイントします。

gcloud compute images deprecate image-v2 \
    --state DEPRECATED \
    --replacement image-v1

イメージファミリーが image-v1 をポイントしていることを確認します。

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '2741732787056801255'
kind: compute#image
name: image-v1
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v1
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v1
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY

カスタムイメージ上でゲストオペレーティングシステムの機能を有効にする

カスタムイメージを作成する際に、guestOsFeatures パラメータを設定できます。このパラメータを使用すると、ブートディスクのためにイメージを使用する VM インスタンスの 1 つ以上の機能を有効にすることができます。次の機能が利用可能です。

MULTI_IP_SUBNET。/32 以外のネットマスクでインターフェースを構成します。
SECURE_BOOT。UEFI セキュアブートオプションを有効にします。これにより、署名のないソフトウェアの起動や、VM インスタンスでの署名のないドライバの読み込みが制限されます。このパラメータを設定すると、VM インスタンスの作成中にセキュアブート機能を有効にできます。
UEFI_COMPATIBLE。UEFI ファームウェアでの起動を有効にします。
VIRTIO_SCSI_MULTIQUEUE。ローカル SSD デバイス用のマルチキュー SCSI 機能を有効にします。このオプションは、NVMe の代替手段です。
- Linux イメージの場合、カーネルバージョン 3.17 以降のイメージで VIRTIO_SCSI_MULTIQUEUE を有効にできます。
- Windows イメージの場合、ドライババージョン 1.2.0.1621 以上のイメージで VIRTIO_SCSI_MULTIQUEUE を有効にできます。
WINDOWS。Windows Server イメージの場合に必要です。Windows Server 用の新しい公開イメージには、それが Windows イメージであることを示す WINDOWS パラメータが含まれています。

gcloud コマンドラインツールまたは API を使用して、カスタムイメージにおけるゲストオペレーティングシステムの機能を有効にします。

gcloud

gcloud compute images create コマンドを使用して、既存のカスタムイメージの一つからカスタムイメージを作成します。また、--guest-os-features フラグも含めます。

gcloud compute images create [IMAGE_NAME] \
  --source-image [SOURCE_IMAGE] \
  --source-image-project [IMAGE_PROJECT] \
  --guest-os-features="[FEATURE_ID],..." \
  --storage-location [LOCATION]

ここで

[IMAGE_NAME] は、作成する新しいイメージの名前です。
[SOURCE_IMAGE] は、イメージの作成元となるイメージです。
[IMAGE_PROJECT] は、ソースイメージを配置するプロジェクトを指定するオプションのパラメータです。このパラメータは、別のプロジェクトからイメージをコピーする場合に使用します。
[FEATURE_ID] は、ゲスト OS で利用可能な機能の ID です。カンマ区切りリストとして複数の機能を指定できます。
[LOCATION] は、イメージを保存するリージョンかマルチリージョンを指定できるオプションのフラグです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。

API

images().insert メソッドに対して POST リクエストを実行します。リクエストの本文内の URL で、イメージの作成元となるソースオブジェクトをポイントします。プロジェクトとゾーンを自分のプロジェクト ID と永続ディスクのゾーンに置き換えます。

永続ディスクからイメージを作成:

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/images

{
 "name": "[IMAGE_NAME]",
 "sourceImage": "projects/[IMAGE_PROJECT]/global/images/[SOURCE_IMAGE]",
 "storageLocations": "[LOCATION]",
 "guestOsFeatures": [
  {
   "type": "[FEATURE_ID]"
  }
 ]
}

ここで

[IMAGE_NAME] は、作成する新しいイメージの名前です。
[SOURCE_IMAGE] は、イメージの作成元となるイメージです。
[IMAGE_PROJECT] は、ソースイメージがどのプロジェクトに配置されているかを指定するパラメータです。
[LOCATION] は、イメージの保存ロケーションを選択できるオプションのパラメータです。たとえば、イメージを us マルチリージョンに保存するには us を指定し、us-central1 リージョンに保存するには us-central1 を指定します。選択しない場合、Compute Engine はイメージのソースのロケーションに最も近いマルチリージョンにイメージを保存します。
[FEATURE_ID] は、ゲスト OS で利用可能な機能の ID です。カンマ区切りリストとして複数の機能を指定できます。

イメージの追加に関する詳細については、イメージ参照をご覧ください。

次のステップ

他のプロジェクトと非公開イメージを共有する。
ディスク、イメージ、VM インスタンスをインポートする方法を学習する。
Cloud Storage にイメージをエクスポートする方法を学習する。
カスタムイメージからインスタンスを起動する方法を学習する。
Jenkins と Packer を使用してカスタムベースイメージを作成する方法を学習する。

カスタム イメージの作成、削除、使用中止

始める前に

カスタム イメージの作成

イメージの保存ロケーションの選択

イメージに対するインスタンスの準備

イメージを作成する

Console

gcloud

API

イメージの使用を中止する

Console

gcloud

API

イメージを削除する

Console

gcloud

API

イメージ ファミリー内のイメージのバージョンを設定する

Console

gcloud

API

gcloud

API

カスタム イメージ上でゲスト オペレーティング システムの機能を有効にする

gcloud

API

次のステップ

カスタムイメージの作成、削除、使用中止

カスタムイメージの作成

イメージファミリー内のイメージのバージョンを設定する

カスタムイメージ上でゲストオペレーティングシステムの機能を有効にする