マシンイメージを作成する

マシンイメージを使用すると、Compute Engine で実行される VM インスタンス用に、すべての構成、メタデータ、権限、データを複数のディスクから格納できます。マシンイメージを作成するために使用する VM インスタンスは、ソース VM インスタンスと呼ばれます。

マシンイメージを使用するタイミングと方法については、マシンイメージをご覧ください。

このドキュメントでは、ソース VM インスタンスからマシンイメージを作成する手順を説明します。

始める前に

• まだ設定していない場合は、認証を設定します。認証とは、 Trusted Cloud by S3NS サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

  After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

  gcloud init

  詳細については、 Trusted Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

制限事項

• 特定のインスタンスのマシンイメージは、60 分ごとに最大 6 回作成できます。
• マシンイメージを保護するには、Cloud Key Management Service（Cloud KMS）または顧客指定の暗号鍵（CSEK）を使用します。暗号鍵はディスクの内容を保護します。ただし、メタデータは保護されません。
• CSEK でマシンイメージを保護する場合、マシンイメージの生成時にすべてのディスクデータの完全なコピーが保存されます。それ以外は、ディスクデータは差分コピーに保存されます。

• 次の条件を満たすソース VM からマシンイメージを作成することはできません。

  • 200 TB を超えるディスクがアタッチされている。
  • アタッチされたディスクがない。
  • Hyperdisk ボリュームがアタッチされている。
  • C3D、H3、A3、Z3 マシンタイプを使用する。

インスタンスとディスクのプロパティがマシンイメージでサポートされていない

VM インスタンスからマシンイメージを作成する場合、またはマシンイメージから VM インスタンスを作成する場合、次のインスタンスとディスクのプロパティは保持または復元されません。

• disks.architecture
• disks.description
• disks.labels
• disks.locked
• disks.multiWriter
• disks.onUpdateAction
• disks.provisionedIops
• disks.shieldedInstanceInitialState
• disks.sourceImage
• disks.sourceImageEncryptionKey
• disks.sourceInstantSnapshot
• disks.sourceSnapshot
• disks.sourceSnapshotEncryptionKey
• privateIpv6GoogleAccess
• resourceManagerTags
• resourcePolicies
• secure_tag
• shieldedInstanceConfig

VM からマシンイメージを作成する

マシンイメージは、Trusted Cloud コンソール、Google Cloud CLI、または REST を使用して作成できます。

マシンイメージを作成するには、次の情報が必要です。

• 作成するマシンイメージの名前。
• ソース VM インスタンスの名前。
• ソース VM インスタンスが配置されているゾーン。
• 説明（省略可）。
• オプションの storageLocation。ロケーションを指定しない場合は、ソース VM インスタンスのマルチリージョンの Cloud Storage ロケーションがデフォルトのストレージ ロケーションとなります。
• オプションの暗号鍵。 Google Cloud-powered encryption key、Cloud Key Management Service（Cloud KMS）鍵、顧客指定の暗号鍵（CSEK）のいずれかを選択できます。暗号鍵が指定されていない場合、マシンイメージは Google Cloud-powered encryption keyを使用して暗号化されます。

• インスタンスのクローン作成とスナップショット作成にマシンイメージを使用する場合は、インスタンスからマシンイメージを生成する前に、そのインスタンスに固有の OS とアプリ情報を削除します。たとえば、Windows VM インスタンスの場合は、GCESysprep を使用してレプリケーション用にシステムを準備します。

gcloud compute machine-images create MACHINE_IMAGE_NAME \
    --source-instance=SOURCE_VM_NAME

gcloud compute machine-images create my-machine-image  \
    --source-instance=my-instance

Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image].
NAME               STATUS
my-machine-image   READY

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages

{
  "name": "MACHINE_IMAGE_NAME",
  "sourceInstance": "SOURCE_INSTANCE_URL"
}

次のステップ

• マシンイメージの詳細を確認する
• マシンイメージから VM インスタンスを作成する