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

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 と権限があることを確認してください。

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

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

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 のうち少なくとも 1 つのフラグが指定されていない限り、デフォルトではクラスタは regular リリースチャネルに登録されます。
VERSION: クラスタに指定するバージョン。

クラスタを作成するときに、必要に応じて --service-account フラグを使用して、Compute Engine のデフォルトサービスアカウントの代わりに、クラスタの最初のノードプール内に存在するノードが使用する別の IAM サービスアカウントを指定できます。最小権限のサービスアカウントを作成して使用することをおすすめします。

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

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

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

コンソール

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 です。マシンタイプごとの料金については、マシンタイプの料金表をご覧ください。
[ブートディスクの種類] プルダウンリストから、ディスクの種類を選択します。
[ブートディスクのサイズ] を入力します。
省略可: ナビゲーションパネルで、[ノードプール] の下の [セキュリティ] をクリックします。
省略可: [サービスアカウント] プルダウンリストから、Google Cloud APIs を呼び出すときにアプリケーションが使用する Identity and Access Management（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 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

コンソール

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 です。マシンタイプごとの料金については、マシンタイプの料金表をご覧ください。
[ブートディスクの種類] プルダウンリストから、ディスクの種類を選択します。
[ブートディスクのサイズ] を入力します。
省略可: ナビゲーションパネルで、[ノードプール] の下の [セキュリティ] をクリックします。
省略可: [サービスアカウント] プルダウンリストから、Google Cloud APIs を呼び出すときにアプリケーションが使用する Identity and Access Management（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 を構成する必要があります。

次のステップ

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

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

概要

始める前に

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

gcloud

コンソール

Terraform

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

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

gcloud

コンソール

Terraform

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

次のステップ

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

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

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