このページは Cloud Translation API によって翻訳されました。

リージョンクラスタを作成する

Standard

このドキュメントでは、Standard リージョンクラスタを作成することにより、クラスタのアップグレード、自動メンテナンス、ゾーン停止の間の、クラスタのコントロールプレーンとワークロードの可用性を高める方法について説明します。

GKE Autopilot クラスタは常にリージョンクラスタです。

概要

ゾーンクラスタではなくリージョンクラスタを作成すると、クラスタのコントロールプレーンは特定のリージョン内の複数のゾーンにわたって複製されます。リージョンクラスタ内のノードプールの場合は、ノードプールを実行するゾーンを手動で指定することも、デフォルト構成を使用して各ノードプールをコントロールプレーンのリージョンの 3 つのゾーンにわたって複製することもできます。すべてのゾーンは、クラスタのコントロールプレーンと同じリージョン内に存在する必要があります。

リージョンクラスタは複数のゾーンにわたってリソースを複製し、追加の割り当てを消費します。

クラスタの可用性のタイプについては、クラスタ構成の選択についてをご覧ください。

以降のセクションでは、次の方法について説明します。

シングルゾーンのノードプールを持つリージョンクラスタを作成する。
マルチゾーンのノードプールを持つリージョンクラスタを作成する。

リージョンクラスタを作成した後は、そのクラスタをゾーンクラスタに変換することはできません。

新しいリージョンクラスタを作成するときに指定する必要がある最小情報は、名前、プロジェクト（通常は現在のプロジェクト）、リージョン（通常はコマンドラインツールのデフォルトのロケーション）です。他のすべての値にはデフォルト設定を使用します。ただし、構成設定には他にも多くのオプションがあります。このガイドではその一部のみを説明します。また、クラスタの作成後に変更できない設定もあります。クラスタの作成後に変更できない設定を理解し、クラスタを再度作成する必要がないように、クラスタの作成時に適切な設定を選択してください。

クラスタ構成オプションの概要については、クラスタ構成の選択についてをご覧ください。使用可能なオプションの一覧については、gcloud container clusters create と Terraform google_container_cluster リファレンスガイドをご覧ください。

始める前に

作業を始める前に、次のことを確認してください。

Google Kubernetes Engine API を有効にする。

Google Kubernetes Engine API の有効化

このタスクに Google Cloud CLI を使用する場合は、gcloud CLI をインストールして初期化する。すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して最新のバージョンを取得する。
注: gcloud CLI がすでにインストールされている場合には、必ず compute/region と compute/zone のプロパティを設定してください。デフォルトの場所を設定することで、gcloud CLI のエラー（One of [--zone, --region] must be supplied: Please specify location など）を防止できます。

クラスタを作成するための適切な権限があることを確認します。少なくとも、Kubernetes Engine Cluster 管理者である必要があります。
新しいクラスタをフリートに登録する場合は、必要な API と権限があることを確認してください。

GKE の IAM サービスアカウントを設定する

GKE は、ノードに接続されている IAM サービスアカウントを使用して、ロギングやモニタリングなどのシステムタスクを実行します。少なくとも、これらのノードサービスアカウントには、プロジェクトに対する Kubernetes Engine デフォルトノードサービスアカウント（roles/container.defaultNodeServiceAccount）ロールが必要です。デフォルトでは、GKE はプロジェクトで自動的に作成される Compute Engine のデフォルトのサービスアカウントをノードサービスアカウントとして使用します。

Compute Engine のデフォルトサービスアカウントに roles/container.defaultNodeServiceAccount ロールを付与する手順は次のとおりです。

console

[ようこそ] ページに移動します。
[ようこそ] に移動
[プロジェクト番号] フィールドで、 [クリップボードにコピー] をクリックします。
[IAM] ページに移動します。
[IAM] に移動
[ アクセスを許可] をクリックします。
[新しいプリンシパル] フィールドに次の値を指定します。
```
PROJECT_NUMBER-compute@developer.gserviceaccount.com
```
PROJECT_NUMBER は、コピーしたプロジェクト番号に置き換えます。
[ロールを選択] メニューで、[Kubernetes Engine のデフォルトノードサービスアカウント] ロールを選択します。
[保存] をクリックします。

gcloud

Google Cloud プロジェクト番号を確認します。
```
gcloud projects describe PROJECT_ID \
    --format="value(projectNumber)"
```
PROJECT_ID を実際のプロジェクト ID に置き換えます。

出力は次のようになります。
```
12345678901
```
Compute Engine のデフォルトサービスアカウントに roles/container.defaultNodeServiceAccount ロールを付与します。
```
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \
    --role="roles/container.defaultNodeServiceAccount"
```
PROJECT_NUMBER は、前の手順で取得したプロジェクト番号に置き換えます。

シングルゾーンのノードプールを持つリージョンクラスタを作成する

次の手順では、リージョン内の単一のゾーンで動作するノードプールを持つリージョンクラスタを作成する方法を説明します。クラスタのコントロールプレーンは、指定されたリージョンの複数のゾーンにわたって複製されますが、ノードは単一のゾーンに配置され、他のゾーンには複製されません。

gcloud CLI、Google Cloud コンソール、または Terraform を使用してクラスタを作成できます。

Cloud Code for VS Code を使用して GKE アプリケーションを開発している場合は、Cloud Code でクラスタを作成してみてください。

gcloud

gcloud CLI でリージョンクラスタを作成するには、以下のいずれかのコマンドを使用します。変数は次のように置き換えます。

CLUSTER_NAME: 新しいリージョンクラスタの名前。
COMPUTE_REGION: クラスタのリージョン（us-central1 など）。
COMPUTE_ZONE: ノードプールのゾーン（us-central1-a など）。このゾーンは、クラスタコントロールプレーンと同じリージョンに存在する必要があります。
CHANNEL: リリースチャネルのタイプ。rapid、regular、stable、None のいずれかに指定できます。少なくとも --cluster-version、--release-channel、--no-enable-autoupgrade、および --no-enable-autorepair のいずれかのフラグが指定されていない限り、デフォルトではクラスタは、デフォルトで regular リリースチャネルに登録されます。
VERSION: クラスタに指定するバージョン。

Compute Engine のデフォルトのサービスアカウントの代わりに、ノードで使用できる最小権限の IAM サービスアカウントを指定することを強くおすすめします。最小権限のサービスアカウントを作成する方法については、最小権限のサービスアカウントを使用するをご覧ください。

gcloud CLI でカスタムサービスアカウントを指定するには、コマンドに次のフラグを追加します。

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

SERVICE_ACCOUNT_NAME は、最小権限のサービスアカウントの名前に置き換えます。

特定のリリースチャネルを使用する場合:

特定のリリースチャネルを使用して新しいクラスタを作成するには、次のコマンドを実行します。

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel CHANNEL

特定のバージョンを使用する場合:

特定のクラスタバージョンを使用して新しいクラスタを作成するには、次のコマンドを実行します。

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

リリースチャンネルに登録されていないクラスタにデフォルトバージョンを使用する場合:

リリースチャンネルに登録されていないクラスタのデフォルトバージョンを使用して新しいクラスタを作成する場合、クラスタバージョンを指定する必要はありませんが、リリースチャンネルを None に設定する必要があります。

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel None

例

次のコマンドは、us-west1-c ゾーンに 3 つのノード（デフォルト）を持つ、regular リリースチャンネル（デフォルト）に登録されたリージョンクラスタを作成します。

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c

例

次のコマンドは、us-west1-c ゾーンに 2 つのノード（デフォルト）を持つ、regular リリースチャンネル（デフォルト）に登録されたリージョンクラスタを作成します。

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

Console

Google Cloud コンソールで [Google Kubernetes Engine] ページに移動します。

Google Kubernetes Engine に移動
[ 作成] をクリックします。
[クラスタの基本] セクションで、次の操作を行います。
1. クラスタの名前を [名前] に入力します。
2. [ロケーションタイプ] で [リージョン] を選択し、クラスタに使用する目的のリージョンを選択します。
3. デフォルトのノードのロケーションをオーバーライドするには（たとえば、シングルゾーンで実行する場合）、[デフォルトのノードのロケーションを指定する] チェックボックスをオンにして、ノードプールを実行するゾーンを選択します。
4. リリースチャンネルを選択します。必要に応じて、プルダウンリストから [チャンネルなし] を選択できます。ただし、このオプションを選択する前に、リリースチャンネルに登録されているクラスタと登録されていないクラスタの比較を確認することをおすすめします。GKE は、リリースチャンネルにないクラスタを、Stable チャンネルのバージョンで自動的にアップグレードします。
5. 省略可: [バージョン] プルダウンリストからコントロールプレーンのバージョンを指定します。
省略可（GKE Enterprise で利用可能）: 新しいクラスタをフリートに登録する場合は、[フリート登録] セクションに移動し、Google Cloud コンソールで新しいクラスタを作成して登録するの手順に沿ってクラスタの登録を完了します。
ナビゲーションペインの [ノードプール] で [default-pool] をクリックします。
[ノードプールの詳細] セクションで、次の操作を行います。
1. [名前] に、デフォルトのノードプールの名前を入力します。
2. 省略可: ノードのバージョンを選択します。
3. [ノード数] に、クラスタ内に作成するノードの数を入力します。ノードとそのリソース（ファイアウォールルートなど）に使用できるリソース割り当てが必要です。
4. 省略可: ノードの自動アップグレードを無効にすることもできますが、このオプションを選択する前に、ノードの自動アップグレードを無効にする際の考慮事項を確認することをおすすめします。
ナビゲーションパネルで、[ノードプール] の下の [ノード] をクリックします。
[イメージの種類] プルダウンリストから、ノードイメージを選択します。
インスタンスに使用するデフォルトのマシンの構成を選択します。マシンタイプごとに課金方法は異なります。デフォルトのマシンタイプは e2-medium です。マシンタイプごとの料金については、マシンタイプの料金表をご覧ください。
[ブートディスクの種類] プルダウンリストから、ディスクの種類を選択します。
[ブートディスクのサイズ] を入力します。
省略可: ナビゲーションパネルで、[ノードプール] の下の [セキュリティ] をクリックします。
必要に応じて、ノードにカスタム IAM サービスアカウントを指定します。
1. [詳細設定] ページで、[セキュリティ] セクションを開きます。
2. [サービスアカウント] メニューで、目的のサービスアカウントを選択します。
Compute Engine のデフォルトのサービスアカウントの代わりに、ノードで使用できる最小権限の IAM サービスアカウントを指定することを強くおすすめします。最小権限のサービスアカウントを作成する方法については、最小権限のサービスアカウントを使用するをご覧ください。

[作成] をクリックします。

Terraform

Terraform を使用してシングルゾーンのノードプールを持つリージョンクラスタを作成するには、次の例をご覧ください。

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-single-zone"
  location           = "us-west1"
  node_locations     = ["us-west1-c"]
  initial_node_count = 2

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Terraform の使用方法の詳細については、GKE での Terraform のサポートをご覧ください。

kubectl を使用してクラスタを操作する

クラスタを作成した後、コマンドラインからクラスタとやり取りするには、その前に kubectl を構成する必要があります。

マルチゾーンのノードプールを持つリージョンクラスタを作成する

次の手順では、マルチゾーンのノードプール（デフォルトの設定）を持つリージョンクラスタを作成する方法を説明します。クラスタのコントロールプレーンとノードは、指定されたリージョン内の複数のゾーンにわたって複製されます。

gcloud CLI、Google Cloud コンソール、または Terraform を使用してクラスタを作成できます。

Visual Studio Code を使用して GKE アプリケーションを開発している場合は、Cloud Code でクラスタを作成してみてください。

gcloud

gcloud CLI でリージョンクラスタを作成するには、以下のいずれかのコマンドを使用します。変数は次のように置き換えます。

CLUSTER_NAME: 新しいリージョンクラスタの名前。
COMPUTE_REGION: クラスタのリージョン（us-central1 など）。
CHANNEL: リリースチャネルのタイプ。rapid、regular、stable、None のいずれかに指定できます。--cluster-version、--release-channel、--no-enable-autoupgrade、--no-enable-autorepair の各フラグが指定されていない場合、クラスタは、デフォルトで regular リリースチャネルに登録されます。
VERSION: クラスタに指定するバージョン。
ゾーンが 4 つ以上あるリージョンの場合や、ゾーンが少ないほうが好ましい場合は、オプションの --node-locations フラグを使用して、ノードが複製されるデフォルトゾーンをオーバーライドできます。

gcloud CLI でカスタムサービスアカウントを指定するには、コマンドに次のフラグを追加します。

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

SERVICE_ACCOUNT_NAME は、最小権限のサービスアカウントの名前に置き換えます。

特定のリリースチャネルを使用する場合:

特定のリリースチャネルを使用して新しいクラスタを作成するには、次のコマンドを実行します。

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel CHANNEL

特定のバージョンを使用する場合:

特定のクラスタバージョンを使用して新しいクラスタを作成するには、次のコマンドを実行します。

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --cluster-version VERSION

リリースチャンネルに登録されていないクラスタにデフォルトバージョンを使用する場合:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel None

例

次のコマンドは、us-west1に 9 つのノードを持つ regular リリースチャネルに登録されたリージョンクラスタを作成します（デフォルトで 3 つのゾーンにそれぞれ 3 つのノードを持ちます）。

gcloud container clusters create my-regional-cluster --region us-west1

例

次のコマンドは、6 つのノードを持つ regular リリースチャネルに登録されたリージョンクラスタを作成します（2 つのノードを持つゾーンが 3 つ、--num-nodes で指定されます）。

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --num-nodes 2

例

次のコマンドでは、2 つのゾーンに 6 つのノードを持つ regular リリースチャネルに登録されたリージョンクラスタが作成されます（3 つのノードを持つゾーンが 2 つ、--node-locations で指定されます）。

gcloud container clusters create my-regional-cluster \
    --region us-central1 \
    --node-locations us-central1-b,us-central1-c

Console

Google Cloud コンソールで [Google Kubernetes Engine] ページに移動します。

Google Kubernetes Engine に移動
[ 作成] をクリックします。
[クラスタの基本] セクションで、次の操作を行います。
1. クラスタの名前を [名前] に入力します。
2. [ロケーションタイプ] で [リージョン] を選択し、クラスタに使用する目的のリージョンを選択します。
3. デフォルトのノードのロケーションをオーバーライドするには（たとえば、シングルゾーンで実行する場合）、[デフォルトのノードのロケーションを指定する] チェックボックスをオンにして、ノードプールを実行するゾーンを選択します。
4. リリースチャンネルを選択します。必要に応じて、プルダウンリストから [チャンネルなし] を選択できます。ただし、このオプションを選択する前に、リリースチャンネルに登録されているクラスタと登録されていないクラスタの比較を確認することをおすすめします。GKE は、リリースチャンネルにないクラスタを、Stable チャンネルのバージョンで自動的にアップグレードします。
5. 省略可: [バージョン] プルダウンリストからコントロールプレーンのバージョンを指定します。
省略可（GKE Enterprise で利用可能）: 新しいクラスタをフリートに登録する場合は、[フリート登録] セクションに移動し、Google Cloud コンソールで新しいクラスタを作成して登録するの手順に沿ってクラスタの登録を完了します。
ナビゲーションペインの [ノードプール] で [default-pool] をクリックします。
[ノードプールの詳細] セクションで、次の操作を行います。
1. [名前] に、デフォルトのノードプールの名前を入力します。
2. 省略可: ノードのバージョンを選択します。
3. [ノード数] に、クラスタ内に作成するノードの数を入力します。ノードとそのリソース（ファイアウォールルートなど）に使用できるリソース割り当てが必要です。
4. 省略可: ノードの自動アップグレードを無効にすることもできますが、このオプションを選択する前に、ノードの自動アップグレードを無効にする際の考慮事項を確認することをおすすめします。
ナビゲーションパネルで、[ノードプール] の下の [ノード] をクリックします。
[イメージの種類] プルダウンリストから、ノードイメージを選択します。
インスタンスに使用するデフォルトのマシンの構成を選択します。マシンタイプごとに課金方法は異なります。デフォルトのマシンタイプは e2-medium です。マシンタイプごとの料金については、マシンタイプの料金表をご覧ください。
[ブートディスクの種類] プルダウンリストから、ディスクの種類を選択します。
[ブートディスクのサイズ] を入力します。
省略可: ナビゲーションパネルで、[ノードプール] の下の [セキュリティ] をクリックします。
必要に応じて、ノードにカスタム IAM サービスアカウントを指定します。
1. [詳細設定] ページで、[セキュリティ] セクションを開きます。
2. [サービスアカウント] メニューで、目的のサービスアカウントを選択します。
Compute Engine のデフォルトのサービスアカウントの代わりに、ノードで使用できる最小権限の IAM サービスアカウントを指定することを強くおすすめします。最小権限のサービスアカウントを作成する方法については、最小権限のサービスアカウントを使用するをご覧ください。

[作成] をクリックします。

Terraform

Terraform を使用してマルチゾーンノードプールを持つリージョンクラスタを作成するには、次の例を参照してください。

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-multi-zone"
  location           = "us-central1"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Terraform の使用方法の詳細については、GKE での Terraform のサポートをご覧ください。

kubectl を使用してクラスタを操作する

クラスタを作成した後、コマンドラインからクラスタとやり取りするには、その前に kubectl を構成する必要があります。

次のステップ

作成できるクラスタのタイプについて確認する。
ゾーンクラスタを作成する。

リージョン クラスタを作成する

概要

始める前に

GKE の IAM サービス アカウントを設定する

console

gcloud

シングルゾーンのノードプールを持つリージョン クラスタを作成する

gcloud

Console

Terraform

kubectl を使用してクラスタを操作する

マルチゾーンのノードプールを持つリージョン クラスタを作成する

gcloud

Console

Terraform

kubectl を使用してクラスタを操作する

次のステップ

リージョンクラスタを作成する

GKE の IAM サービスアカウントを設定する

シングルゾーンのノードプールを持つリージョンクラスタを作成する

マルチゾーンのノードプールを持つリージョンクラスタを作成する