VM で Hyperdisk Extreme ボリュームまたは Hyperdisk Throughput ボリュームを使用するには、次のタスクを行います。
- 空の非ブート ボリュームとゾーンの Hyperdisk ボリュームを作成し、VM 作成の一環として、または個別のタスクとして VM にアタッチします。
- ボリュームをフォーマットしてマウントし、データまたはファイル システムにアクセスできるようにします。
Hyperdisk Balanced ボリュームの場合も同じです。ただし、Hyperdisk Balanced タイプのブートディスクも作成できます。
Hyperdisk に関する一般的な情報については、Hyperdisk についてをご覧ください。
準備
- Hyperdisk ボリュームを VM に追加する前に、Hyperdisk の制限を確認します。
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud のサービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Compute インスタンス管理者(v1)(
roles/compute.instanceAdmin.v1
) -
サービス アカウントとして実行できる VM に接続する: サービス アカウント ユーザー(v1)(
roles/iam.serviceAccountUser
) -
Hyperdisk ボリュームを作成してアタッチするには:
- プロジェクトに対する
compute.disks.create
権限 - VM に対する
compute.instances.attachDisk
権限 -
VM にアタッチするボリュームに対する
compute.disks.use
権限
- プロジェクトに対する
-
アタッチされたボリュームをフォーマットしてマウントするには: VM に対する
compute.instances.setMetadata
権限 [VM インスタンス] ページに移動します。
ディスクを追加する VM の名前をクリックします。
[VM インスタンスの詳細] ページで、[編集] をクリックします。
[追加ディスク] で [新しいディスクを追加] をクリックします。
ディスクの名前を指定し、必要に応じて説明を追加します。[ディスクソースのタイプ] として [空のディスク] を選択します。
[ディスクの設定] で、次のリストからディスクタイプを選択します。指定する値は、サポートされている値の範囲内にする必要があります。
- Hyperdisk Balanced。デフォルトのディスクの [サイズ]、[プロビジョニングされた IOPS]、[プロビジョニングされたスループット] の設定を変更することもできます。
- Hyperdisk Extreme。デフォルトのディスクの [サイズ] と [プロビジョニングされた IOPS] の設定を変更することもできます。
- Hyperdisk ML。デフォルトのディスクの [サイズ] と [プロビジョニングされたスループット] の設定を変更することもできます。
- [ハイパーディスク スループット]。デフォルトのディスクの [サイズ] と [プロビジョニングされたスループット] 設定を変更することもできます。
省略可: Hyperdisk Balanced ボリュームまたは Hyperdisk Balanced High Availability(プレビュー)ボリュームの場合、マルチライター モードでディスクを作成すると、ディスクを複数の VM にアタッチできます。[アクセスモード] で、[複数の VM の読み取り / 書き込み] を選択します。
[保存] をクリックします。
変更を VM に適用するには、[保存] をクリックします。
gcloud compute disks create
コマンドを使用して、Hyperdisk ボリュームを作成します。gcloud compute disks create DISK_NAME \ --zone=ZONE \ --size=DISK_SIZE \ --type=DISK_TYPE \ --provisioned-iops=IOPS_LIMIT --provisioned-throughput=THROUGHPUT_LIMIT --access-mode=DISK_ACCESS_MODE
次のように置き換えます。
DISK_NAME
: 新しいディスクの名前。ZONE
: 新しいディスクが作成されるゾーンの名前。DISK_SIZE
: 省略可。新しいディスクのサイズ。この値は整数で、その後に GB(ギビバイト)または TB(テビバイト)のサイズ単位が続きます。サイズ単位が指定されていない場合、デフォルト値として 100 GB が使用されます。ディスクサイズに指定できる値は次のとおりです。- Hyperdisk Balanced: 4 GiB から 64 TiB まで(1 GiB 単位で指定します)。
- Hyperdisk Extreme: 64 GiB から 64 TiB まで(1 GiB 単位で指定します)。
- Hyperdisk ML: 4 GiB から 64 TiB まで(1 GiB 単位で指定します)。
- Hyperdisk Throughput: 2 TiB から 32 TiB まで(1 GiB 単位で指定します)。
DISK_TYPE
: ディスクのタイプ。hyperdisk-balanced
、hyperdisk-extreme
、hyperdisk-ml
、hyperdisk-throughput
のいずれかの値を使用します。IOPS_LIMIT
: 省略可。Hyperdisk Balanced ディスクまたは Hyperdisk Extreme ディスクの場合、これはディスクが処理できる 1 秒あたりの I/O オペレーション(IOPS)の数です。THROUGHPUT_LIMIT
: 省略可。Hyperdisk Balanced ボリューム、Hyperdisk ML ボリューム、または Hyperdisk Throughput ボリュームの場合、これはディスクが処理できるスループット(MiB/秒で測定)を表す整数です。DISK_ACCESS_MODE
: 省略可。VM がディスク上のデータにアクセスする方法。サポートされている値は次のとおりです。READ_WRITE_SINGLE
: 1 台の VM からの読み取り / 書き込みアクセス。これがデフォルトです。READ_WRITE_MANY
: 複数の VM からの読み取り / 書き込みアクセス。READ_ONLY_MANY
: 複数の VM からの読み取り専用アクセス。
アクセス モードは、次のディスクタイプに設定できます。
- Hyperdisk Balanced
- Hyperdisk ML
- Hyperdisk Balanced High Availability(プレビュー)
省略可:
gcloud compute disks describe DISK_NAME
コマンドを使用して、ディスクの説明を表示します。ディスクの作成後、ディスクを VM にアタッチできます。
disks.insert
メソッドを使用して、ゾーン Hyperdisk を作成するPOST
リクエストを作成します。name
、sizeGb
、type
、provisionedIops
、provisionedThroughput
プロパティを含めます。このディスクを空のフォーマットされていない非ブートディスクとして作成する場合、ソースイメージやソース スナップショットを指定しないでください。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sizeGb": "DISK_SIZE", "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE", "provisionedIops": "IOPS_LIMIT", "provisionedThroughput": "THROUGHPUT_LIMIT", "accessMode": "DISK_ACCESS_MODE" }
次のように置き換えます。
PROJECT_ID
: プロジェクト IDZONE
: VM と新しいディスクが配置されるゾーンDISK_NAME
: 新しいディスクの名前DISK_SIZE
: 省略可。新しいディスクのサイズ。この値は整数で、その後に GB(ギビバイト)または TB(テビバイト)のサイズ単位が続きます。DISK_TYPE
: ディスクのタイプ。Hyperdisk ボリュームを作成するには、次のいずれかの値を使用します。hyperdisk-balanced
、hyperdisk-extreme
、hyperdisk-ml
、またはhyperdisk-throughput
。IOPS_LIMIT
: 省略可。Hyperdisk Balanced と Hyperdisk Extreme の場合、これはディスクが処理できる 1 秒あたりの I/O オペレーションの数です。THROUGHPUT_LIMIT
: 省略可。Hyperdisk Balanced ボリューム、Hyperdisk ML ボリューム、または Hyperdisk Throughput ボリュームの場合、これはディスクが処理できるスループット(MiB/秒で測定)を表す整数です。DISK_ACCESS_MODE
: VM がディスク上のデータにアクセスする方法。サポートされている値は次のとおりです。READ_WRITE_SINGLE
: 1 台の VM からの読み取り / 書き込みアクセス。これがデフォルトです。READ_WRITE_MANY
: 複数の VM からの読み取り / 書き込みアクセス。READ_ONLY_MANY
: 複数の VM からの読み取り専用アクセス。
アクセス モードは、次のディスクタイプに設定できます。
- Hyperdisk Balanced
- Hyperdisk ML
- Hyperdisk Balanced High Availability(プレビュー)
省略可:
compute.disks.get
メソッドを使用して、ディスクの説明を表示します。ディスクの作成後、実行中または停止中の VM にディスクをアタッチできます。
- Linux: Linux VM で非ブートディスクをフォーマットしてマウントするをご覧ください。
- Windows: Windows VM での非ブートディスクのフォーマットとマウントをご覧ください。
- ハイパーディスク ボリュームの IOPS とスループットをカスタマイズする方法を学習する。
- 予期しないデータ損失を回避するため、定期的にスナップショットを使用してディスクをバックアップする方法を確認する。
Go
ローカル開発環境でこのページの Go サンプルを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。
詳細については Set up authentication for a local development environment をご覧ください。
Java
ローカル開発環境でこのページの Java サンプルを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。
詳細については Set up authentication for a local development environment をご覧ください。
Node.js
ローカル開発環境でこのページの Node.js サンプルを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。
詳細については Set up authentication for a local development environment をご覧ください。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
必要なロールと権限
VM への Hyperdisk ボリュームの追加に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
これらの事前定義ロールには、VM への Hyperdisk ボリュームの追加に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
VM に Hyperdisk ボリュームを追加するには、次の権限が必要です。
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
Hyperdisk ボリュームでサポートされる値
Hyperdisk ボリュームを作成または変更するときに使用する値は、ディスクあたりの Hyperdisk の上限で説明されている最大値と最小値の範囲内にする必要があります。
VM にアタッチされている Hyperdisk ボリュームのサイズを変更する場合、新しい値は VM あたりの Hyperdisk の上限を超えることはできません。
Hyperdisk ボリュームにプロビジョニングされる IOPS とスループットは、Hyperdisk の IOPS とスループットのプロビジョニングについてで説明されているルールに沿っている必要があります。
VM に Hyperdisk ボリュームを追加する
Hyperdisk ボリュームを作成してアタッチするには、Google Cloud コンソール、Google Cloud CLI、または REST を使用します。
Hyperdisk ボリュームの作成時に指定するサイズ、スループット、IOPS は、サポートされている値の範囲内にする必要があります。
Hyperdisk Balanced ボリュームまたは Hyperdisk Balanced High Availability(プレビュー)ボリュームを作成する場合は、必要に応じて、マルチライター モードでディスクを作成し、複数の VM がディスクにアクセスできるようにします。
コンソール
gcloud
REST
Go
Java
Node.js
ディスクの作成後、実行中または停止中の VM にディスクをアタッチできます。
ディスクをフォーマットしてマウントする
新しいディスクを作成して VM にアタッチしたら、ディスクをフォーマットしてマウントする必要があります。この操作を行うことで、オペレーティング システムが保存容量を使用できるようになります。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-05 UTC。
-