永続ディスクを VM に追加します。


空の永続ディスクを作成するか、データソースからディスクを作成できます。永続ディスクは、仮想マシン(VM)インスタンスのブートディスクとして使用できます。または、VM にアタッチするデータディスクとして使用することもできます。このドキュメントでは、次の操作を行う方法について説明します。

  • 空の非ブートゾーン永続ディスクを作成し、VM インスタンスにアタッチします。
  • このディスクはデータやファイル システムが存在しない状態で起動するため、フォーマットしてマウントします。

永続ディスクに関する一般的な情報と使用可能なディスクタイプについては、永続ディスクの概要をご覧ください。

始める前に

制限事項

  • インスタンスの作成時に、最大 127 個のセカンダリ(非ブート)ゾーン永続ディスクをアタッチできます。
  • 合計接続容量は 1 インスタンスあたり 257 TB です。大容量のボリュームでパフォーマンスを最大限に高める方法については、論理ボリューム サイズをご覧ください。

VM に非ブートディスクを追加する

Google Cloud コンソールGoogle Cloud CLI、または Compute Engine API を使用して、非ブート ゾーンディスクを作成してアタッチします。

Google Cloud コンソールでディスクを作成する場合、デフォルトのディスクタイプpd-balanced です。gcloud CLI または Compute Engine API を使用してディスクを作成する場合、デフォルトのディスクタイプは pd-standard です。

Console

  1. [VM インスタンス] ページに移動します。

    [VM インスタンス] ページに移動

  2. このチェックボックスをオンにして、ディスクを追加するインスタンス名をクリックします。

  3. [VM インスタンスの詳細] ページで、[編集] をクリックします。

  4. [追加ディスク] で、[新しいディスクを追加] をクリックします。

  5. ディスクの名前を指定して、ディスクのプロパティを構成し、[ソースの種類] として [空白] を選択します。

  6. [完了] をクリックしてディスクの構成を完了します。

  7. [保存] をクリックして変更をインスタンスに適用し、新しいディスクを追加します。

gcloud

  1. Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。

    Cloud Shell をアクティブにする

    Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

  2. gcloud compute disks create コマンドを使用してゾーン永続ディスクを作成します。

    gcloud compute disks create DISK_NAME \
      --size DISK_SIZE \
      --type DISK_TYPE
    

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

    • DISK_NAME: 新しいディスクの名前。
    • DISK_SIZE: 新しいディスクのサイズ(ギガバイト単位)。使用できるサイズは、1 GB 単位で 10~65,536 GB の範囲です。
    • DISK_TYPE: 永続ディスクのタイプの完全な URL または部分的な URL例: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd
  3. ディスクを作成したら、実行中または停止しているインスタンスにアタッチします。gcloud compute instances attach-disk コマンドを使用します。

    gcloud compute instances attach-disk INSTANCE_NAME \
      --disk DISK_NAME
    

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

    • INSTANCE_NAME: 新しいゾーン永続ディスクを追加するインスタンスの名前。
    • DISK_NAME: インスタンスにアタッチする新しいディスクの名前。
  4. gcloud compute disks describe コマンドを使用して、ディスクの説明を表示します。

Terraform

ディスクを作成するには、google_compute_disk リソースを使用します。

# Using pd-standard because it's the default for Compute Engine

resource "google_compute_disk" "default" {
  name = "disk-data"
  type = "pd-standard"
  zone = "us-west1-a"
  size = "5"
}

ディスクを VM にアタッチするには、google_compute_instance リソースを使用します。

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

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

REST

  1. API で、disks.insert メソッドを使用して POST リクエストを作成し、ゾーン永続ディスクを作成します。namesizeGbtype プロパティを含めます。このディスクを空のフォーマットされていない非ブートディスクとして作成する場合、ソースイメージやソース スナップショットを指定しないでください。

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks
    
    {
     "name": "DISK_NAME",
     "sizeGb": "DISK_SIZE",
     "type": "DISK_TYPE"
    }
    

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

    • PROJECT_ID: プロジェクト ID。
    • ZONE: インスタンスと新しいディスクが配置されるゾーン。
    • DISK_NAME: 新しいディスクの名前。
    • DISK_SIZE: 新しいディスクのサイズ(ギガバイト単位)。使用できるサイズは、1 GB 単位で 10~65,536 GB の範囲です。
    • DISK_TYPE: 永続ディスクのタイプの完全な URL または部分的な URL例: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE/diskTypes/pd-ssd
  2. 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/zones/ZONE/disks/DISK_NAME"
    }
    

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

    • PROJECT_ID: プロジェクト ID
    • ZONE: インスタンスと新しいディスクが配置されるゾーン。
    • INSTANCE_NAME: 新しい永続ディスクを追加するインスタンスの名前。
    • DISK_NAME: 新しいディスクの名前

新しいディスクを作成して VM にアタッチしたら、ディスクをフォーマットしてマウントする必要があります。これにより、使用可能な保存容量をオペレーティング システムが使用できるようになります。

次のステップ