永続ディスクをインスタンスに追加する

Linux Windows

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

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

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

始める前に

このガイドのコマンドラインの例を使用する場合は、次の操作を行います。
1. Google Cloud CLI の最新バージョンをインストールするか、最新バージョンに更新します。
2. デフォルトのリージョンとゾーンを設定します。
このガイドの API の例を使用する場合、API アクセスを設定します。

制限事項

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

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

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

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

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

新しいディスクを作成するためのプロジェクトに関する compute.disks.create
仮想マシン（VM）インスタンス上の compute.instances.attachDisk
接続するディスクに対する compute.disks.use 権限

Console

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

[VM インスタンス] ページに移動
このチェックボックスをオンにして、ディスクを追加するインスタンス名をクリックします。
[VM インスタンスの詳細] ページで、[編集] をクリックします。
[追加ディスク] で、[新しいディスクを追加] をクリックします。
ディスクの名前を指定して、ディスクのプロパティを構成し、[ソースの種類] として [空白] を選択します。
[完了] をクリックしてディスクの構成を完了します。
[保存] をクリックして変更をインスタンスに適用し、新しいディスクを追加します。

gcloud

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

Cloud Shell をアクティブにする

Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドラインプロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
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
ディスクを作成したら、実行中または停止しているインスタンスにアタッチします。gcloud compute instances attach-disk コマンドを使用します。
```
gcloud compute instances attach-disk INSTANCE_NAME \
  --disk DISK_NAME
```
次のように置き換えます。
- INSTANCE_NAME: 新しいゾーン永続ディスクを追加するインスタンスの名前。
- DISK_NAME: インスタンスにアタッチする新しいディスクの名前。
gcloud compute disks describe コマンドを使用して、ディスクの説明を表示します。

Terraform

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

compute/add_persistent_disk/main.tf

GitHub で表示フィードバック

# 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 リソースを使用します。

compute/add_persistent_disk/main.tf

GitHub で表示フィードバック

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 コマンドをご覧ください。

API

API で、disks.insert メソッドを使用して POST リクエストを作成し、ゾーン永続ディスクを作成します。name、sizeGb、type プロパティを含めます。このディスクを空のフォーマットされていない非ブートディスクとして作成する場合、ソースイメージやソーススナップショットを指定しないでください。
```
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
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 にアタッチしたら、ディスクをフォーマットしてマウントする必要があります。この操作を行うことで、オペレーティングシステムが保存容量を使用できるようになります。

Linux VM に非ブートディスクをフォーマットしてマウントする

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

SSH を使用した接続を可能にする、インスタンスに対する compute.instances.setMetadata 権限。

サービスアカウントとして実行できる VM インスタンスに接続する場合は、roles/iam.serviceAccountUser のロールも付与する必要があります。

VM への接続

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

[VM インスタンス] ページに移動
新たにディスクをアタッチしたインスタンスの横にある [SSH] ボタンをクリックします。ブラウザが開き、インスタンスに対するターミナル接続が表示されます。

ディスクのフォーマット

ターミナルで、lsblk コマンドを使用してインスタンスにアタッチされているディスクを一覧表示し、フォーマットしてマウントするディスクを探します。
```
  $ sudo lsblk
  
  NAME   MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
  sda      8:0    0   10G  0 disk
  └─sda1   8:1    0   10G  0 part /
  sdb      8:16   0  250G  0 disk
  
```
この例では、sdb が新しい空の永続ディスクのデバイス名です。
mkfs ツールを使用してディスクをフォーマットします。このコマンドを実行すると、指定したディスクからすべてのデータが削除されます。正しいディスクデバイスを指定してください。

ファイル形式は任意ですが、パーティション分割テーブルのない単一の ext4 ファイルシステムがおすすめです。ディスク �