リージョン ディスクを作成して管理する

コンソール

1. Google Cloud コンソールで、[ディスク] ページに移動します。

   [ディスク] に移動

2. 必要なプロジェクトを選択します。

3. [ディスクを作成] をクリックします。

4. [名前] でディスクの名前を指定します。

5. [ロケーション] で [リージョン] を選択します。

6. リージョンとゾーンを選択します。インスタンスの作成時に同じリージョンを選択する必要があります。

7. 同じリージョン内の [レプリカゾーン] を選択します。いずれかのゾーンのインスタンスにディスクを接続する必要があるため、選択したゾーンをメモしておきます。

8. [ディスクソースのタイプ] を選択します。

9. [ディスクの設定] で、ディスクタイプとサイズを選択します。デフォルトの [プロビジョニングされた IOPS] と [プロビジョニングされたスループット] の設定を変更することもできます。

10. 省略可: Hyperdisk Balanced High Availability ボリュームの場合は、マルチライター モードでディスクを作成することによって、ディスクを複数のインスタンスにアタッチできます。[アクセスモード] で、[複数の VM の読み取り / 書き込み] を選択します。

11. [作成] をクリックして、ディスクの作成を終了します。

gcloud

compute disks create コマンドを使用してリージョン ディスクを作成します。

スループットや IOPS を上げるためにリージョン SSD 永続ディスクが必要な場合は、--type フラグで pd-ssd を指定します。

gcloud compute disks create DISK_NAME \
   --size=DISK_SIZE \
   --type=DISK_TYPE \
   --region=REGION \
   --replica-zones=ZONE1,ZONE2
   --access-mode=DISK_ACCESS_MODE

次のように置き換えます。

• DISK_NAME: 新しいディスクの名前
• DISK_SIZE: 新しいディスクのサイズ（GiB）
• DISK_TYPE:リージョン Persistent Disk の場合、これはリージョン ディスクのタイプです。デフォルト値は pd-standard です。 Hyperdisk の場合は、値 hyperdisk-balanced-high-availability を指定します。
• REGION: リージョン ディスクを配置するリージョン（例: europe-west1）
• ZONE1、ZONE2: 2 つのディスク レプリカが配置されるリージョン内のゾーン（例: europe-west1-b,europe-west1-c）

• DISK_ACCESS_MODE: 省略可。インスタンスが Hyperdisk Balanced High Availability ディスク上のデータにアクセスする方法を指定します。次の値を使用できます。

  • READ_WRITE_SINGLE: 1 つのインスタンスからの読み取り / 書き込みアクセス。これがデフォルトです。
  • READ_WRITE_MANY: 複数のインスタンスからの読み取り / 書き込みアクセス。

  アクセスモードを設定できるのは、Hyperdisk Balanced High Availability ディスクに対してのみです。

Terraform

リージョン Persistent Disk または Hyperdisk Balanced High Availability を作成するには、google_compute_region_disk リソースを使用します。

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

REST

リージョン Persistent Disk または Hyperdisk Balanced High Availability ボリュームを作成するには、compute.regionDisks.insert メソッドに POST リクエストを作成します。

空のディスクを作成するには、スナップショット ソースを指定しないでください。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks
{
  "name": "DISK_NAME",
  "region": "projects/PROJECT_ID/regions/REGION",
  "replicaZones": [
    "projects/PROJECT_ID/zones/ZONE1",
    "projects/PROJECT_ID/zones/ZONE2"
  ],
  "sizeGb": "DISK_SIZE",
  "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
  "accessMode": "DISK_ACCESS_MODE"
}

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• REGION: リージョン ディスクを配置するリージョン（例: europe-west1）
• DISK_NAME: 新しいディスクの名前
• ZONE1、ZONE2: 新しいディスクのレプリカが配置されるゾーン。
• DISK_SIZE: 新しいディスクのサイズ（GiB）
• DISK_TYPE:リージョン永続ディスクの場合、これは Persistent Disk のタイプです。 Hyperdisk の場合は、値 hyperdisk-balanced-high-availability を指定します。

• DISK_ACCESS_MODE: 省略可。インスタンスが Hyperdisk Balanced High Availability ディスク上のデータにアクセスする方法を指定します。次の値を使用できます。

  • READ_WRITE_SINGLE: 1 つのインスタンスからの読み取り / 書き込みアクセス。これがデフォルトです。
  • READ_WRITE_MANY: 複数のインスタンスからの読み取り / 書き込みアクセス。

  アクセスモードを設定できるのは、Hyperdisk Balanced High Availability ディスクに対してのみです。

コンソール

1. ディスクをインスタンスにアタッチするには、[VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. [名前] 列で、インスタンスの名前をクリックします。

3. [編集] edit をクリックします。

4. [+ 既存のディスクを接続] をクリックします。

5. 以前に作成したリージョン ディスクを選択してインスタンスに追加します。

6. 選択したディスクがすでに別のインスタンスに接続されているという警告が表示された場合は、[ディスクを強制接続する] ボックスを選択して、編集しているインスタンスにディスクを強制的にアタッチします。

   リージョン ディスクのフェイルオーバーで、リージョン ディスクを強制的にアタッチするユースケースを確認します。

7. 省略可: Hyperdisk Balanced High Availability ディスクを複数のインスタンスにアタッチする場合は、[ディスク アタッチメント モード] で [読み取り / 書き込み] を選択します。

8. [保存] をクリックします。

9. [VM の編集] ページで、[保存] をクリックします。

gcloud

リージョン たディスクを実行中または停止中のインスタンスにアタッチするには、--disk-scope フラグを regional に設定して compute instances attach-disk コマンドを使用します。

マルチライター モードで Hyperdisk Balanced High Availability ディスクを複数のインスタンスにアタッチする場合、サポートされているアタッチメント モードは rw のみです。これはデフォルトのアクセスモードです。--mode フラグを含める必要はありません。

gcloud compute instances attach-disk INSTANCE_NAME \
    --disk=DISK_NAME \
    --disk-scope=regional \
    --device-name=DEVICE_NAME

次のように置き換えます。

• INSTANCE_NAME: リージョン ディスクを追加するインスタンスの名前
• DISK_NAME: インスタンスにアタッチする新しいディスクの名前。
• DEVICE_NAME: 省略可。ゲスト OS がシンボリック リンクの作成に使用する名前。OS レベルでディスクの識別に役立ちます。

Terraform

リージョン Persistent Disk または Hyperdisk Balanced High Availability ボリュームをインスタンスにアタッチするには、google_compute_attached_disk リソースを使用します。

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }


}

REST

実行中または停止中のインスタンスにリージョン ディスクをアタッチするには、compute.instances.attachDisk メソッドに POST リクエストを作成し、作成したリージョン ディスクの URL を指定します。

マルチライター モードで Hyperdisk Balanced High Availability ディスクを複数のインスタンスにアタッチする場合、サポートされているアタッチメント モードは READ-WRITE のみです。これはデフォルトのアクセスモードです。mode プロパティを含める必要はありません。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
{
  "source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME",
  "deviceName": DEVICE_NAME
}

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• ZONE: インスタンスの場所
• INSTANCE_NAME: 新しいリージョン ディスクを追加するインスタンスの名前
• REGION: リージョン ディスクが配置されるリージョン
• DISK_NAME: リージョン ディスクの名前（ Google Cloud コンソールに表示される名前）。
• DEVICE_NAME: 省略可。ゲスト OS がシンボリック リンクの作成に使用する名前。OS レベルでディスクの識別に役立ちます。

コンソール

1. Google Cloud コンソールで [インスタンスの作成] ページに移動します。

   [インスタンスの作成] に移動

   プロンプトが表示されたら、プロジェクトを選択して [続行] をクリックします。

   [インスタンスの作成] ページが表示され、[マシンの構成] ペインが表示されます。

2. [マシンの構成] ペインで、次の操作を行います。

   1. [名前] フィールドに、インスタンスの名前を指定します。詳細については、リソースの命名規則をご覧ください。

   2. 省略可: [ゾーン] フィールドで、このインスタンスのゾーンを選択します。

      デフォルトでは [すべて] が選択されています。このデフォルトの選択を変更しない場合は、マシンタイプと可用性に基づいてゾーンが自動的に選択されます。

   3. 次のいずれかのオプションから、インスタンスのマシン ファミリーを選択します。

      • 汎用
      • コンピューティング最適化
      • メモリ最適化
      • ストレージ最適化
      • GPU

      選択したマシン ファミリーで使用可能なマシンシリーズが Google Cloud コンソールに表示されます。

   4. [シリーズ] 列で、インスタンスのマシンシリーズを選択します。

      前の手順でマシン ファミリーとして [GPU] を選択した場合は、必要な [GPU のタイプ] を選択します。選択した GPU のタイプに対して、マシンシリーズが自動的に選択されます。

   5. [マシンタイプ] セクションで、インスタンスのマシンタイプを選択します。

3. ナビゲーション メニューで [OS とストレージ] をクリックします。表示された [オペレーティング システムとストレージ] ペインで、次の操作を行います。

   新しいディスクを追加する際に構成できるパラメータの詳細については、Persistent Disk についてと Google Cloud Hyperdisk についてをご覧ください。

   1. ブートディスクの構成を開始するには、[変更] をクリックします。[ブートディスク] ペインが表示され、[公開イメージ] タブが表示されます。

   2. 次のいずれかの方法で、ブートディスクのデータソースを構成します。

      • ブートディスクのデータソースとして標準スナップショットを選択するには、[スナップショット] をクリックし、表示された [スナップショット] タブで次のように指定します。

        1. [スナップショット] リストで、スナップショットを選択します。
        2. [ブートディスクの種類] リストで、ブートディスクの種類を選択します。
        3. [サイズ（GB）] フィールドで、ブートディスクのサイズを指定します。

      • ブートディスクのデータソースとしてアーカイブ スナップショットを選択するには、[アーカイブ スナップショット] をクリックし、表示された [アーカイブ スナップショット] タブで次のように指定します。

        1. [アーカイブ スナップショット] リストで、アーカイブ スナップショットを選択します。
        2. [ブートディスクの種類] リストで、ブートディスクの種類を選択します。
        3. [サイズ（GB）] フィールドで、ブートディスクのサイズを指定します。

      • 既存のディスクをブートディスクとして選択するには、[既存のディスク] をクリックします。次に、表示された [既存のディスク] タブで、[ディスク] リストから既存のリージョン Persistent Disk または Hyperdisk Balanced High Availability ボリュームを選択します。

   3. 省略可: 詳細な構成オプションについては、[expand_more詳細設定を表示] セクションを展開します。

   4. ブートディスクのオプションを確認して [オペレーティング システムとストレージ] ペインに戻るには、[選択] をクリックします。

   5. 省略可: 非ブートディスクをインスタンスにアタッチする方法については、非ブートディスクを追加したインスタンスを作成するをご覧ください。

4. 既存のブートディスクを選択しなかった場合は、次の手順でリージョン ディスクとして構成します。

   1. ナビゲーション メニューで [データ保護] をクリックします。表示された [データ保護] ペインで、次の操作を行います。

      1. インスタンスで同期ディスク レプリケーション（リージョン Persistent Disk または Hyperdisk Balanced High Availability）を使用するように、すべての新しいディスクを構成するには、[リージョン ディスク] チェックボックスをオンにします

      2. （デフォルトでは対応は不要です）。[ブートディスクを除外] チェックボックスをオフにします。

5. 省略可: その他の構成オプションを指定します。詳細については、インスタンス作成時の構成オプションをご覧ください。

6. インスタンスを作成して起動するには、[作成] をクリックします。

gcloud

gcloud compute instances create コマンドを使用してインスタンスを作成し、--create-disk フラグを使用してリージョン ディスクを指定します。

gcloud compute instances create PRIMARY_INSTANCE_NAME  \
 --zone=ZONE  \
 --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE

disk パラメータを指定する際、文字 ^:^ はパラメータ間の区切り文字がコロン（:）であることを示します。これにより、replica-zones パラメータを指定する際にカンマ（,）を使用できます。

次のように置き換えます。

• PRIMARY_INSTANCE_NAME: インスタンスの名前
• ZONE: インスタンスを作成するゾーンの名前
• REGIONAL_DISK_NAME: リージョン ディスクの名前
• DISK_TYPE: 作成するディスクのタイプ。例: hyperdisk-balanced-high-availability Persistent Disk を使用する場合は、--create-disk フラグ内に scope=regional を指定して、リージョン Persistent Disk を作成する必要があります。
• SNAPSHOT_NAME: ブートディスク用に作成したスナップショットの名前
• REMOTE_ZONE: リージョン ディスクの代替ゾーン

REST

instances.insert メソッドに POST リクエストを作成し、boot: 'true' プロパティと replicaZones プロパティを指定します。例:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• ZONE: インスタンスを作成するゾーンの名前
• INSTANCE_NAME: インスタンスの名前
• BOOT_SNAPSHOT_NAME: ブートディスク スナップショットの名前
• REMOTE_ZONE: リージョン ディスクのリモートゾーン
• DISK_TYPE: 作成するディスクのタイプ。例: hyperdisk-balanced-high-availability、 、pd-balanced

gcloud

1. インスタンスを停止します。

   gcloud compute instances stop INSTANCE_NAME  --zone=ZONE
   

2. 現在のブートディスクをインスタンスから切断します。

   gcloud compute instances detach-disk INSTANCE_NAME \
    --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
   

3. リージョン ブートディスクをインスタンスにアタッチします。

   gcloud compute instances attach-disk INSTANCE_NAME  \
    --zone=ZONE  \
    --disk=REGIONAL_DISK_NAME  \
    --disk-scope=regional --force-attach \
    --boot
   

4. インスタンスを再起動します。

   gcloud compute instances start INSTANCE_NAME
   

上記のコマンドの変数を次のように置き換えます。

• INSTANCE_NAME: リージョン ブートディスクをアタッチするインスタンスの名前
• ZONE: インスタンスを配置するゾーン
• CURRENT_BOOT_DEVICE_NAME: インスタンスで使用されているブートディスクの名前。通常、これはインスタンスの名前と同じです。
• REGIONAL_DISK_NAME: ブートディスクとしてインスタンスにアタッチするリージョン ディスクの名前

省略可: 停止または障害によって、プライマリ インスタンスからリージョン ブートディスクを正常に切断できない場合は、--force-attach フラグを含めます。

REST

1. インスタンスを停止します。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
   

2. 現在のブートディスクをインスタンスから切断します。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME
   

3. リージョン ブートディスクをインスタンスにアタッチします。

   compute.instances.attachDisk メソッドに POST リクエストを作成し、リージョン ブートディスクへの URL を指定します。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
   {
   "source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REGIONAL_DISK_NAME",
   "boot": true
   }

4. インスタンスを再起動します。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
   

上記のコマンドの変数を次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• INSTANCE_NAME: リージョン ディスクをアタッチするインスタンスの名前
• ZONE: インスタンスを配置するゾーン
• CURRENT_BOOT_DEVICE_NAME: インスタンスで使用されているブートディスクの名前。通常、これはインスタンスの名前と同じです。
• REGION: リージョン ディスクを配置するリージョン
• REGIONAL_DISK_NAME: ブートディスクとしてインスタンスにアタッチするリージョン ディスクの名前

省略可: 停止または障害のために、最初にアタッチしたインスタンスからリージョン ブートディスクを正常に切断できない場合は、リクエストの本文に "forceAttach": true を含めます。