ゾーンクラスタの作成

Standard

このドキュメントでは、Google Kubernetes Engine（GKE）のデフォルトの機能を使用して Standard ゾーンクラスタを作成する方法について説明します。ゾーンクラスタには、1 つのゾーン内に 1 つのコントロールプレーンが含まれています。可用性の要件に応じて、ゾーンクラスタのノードを単一のゾーンに分散するか、複数のゾーンに分散するかを選択できます。

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

シングルゾーンとマルチゾーン

シングルゾーンクラスタには、1 つのゾーンで動作する 1 つのコントロールプレーンが含まれています。このコントロールプレーンは、同じゾーンで動作するノード上のワークロードを管理します。ワークロードを単一のゾーンで実行する場合、ゾーンが停止した場合、このワークロードは使用できません。

マルチゾーン クラスタのノードは複数のゾーンで実行されますが、コントロールプレーンのレプリカは 1 つだけです。複数のゾーンでワークロードを実行していて、ゾーンが停止した場合、そのゾーンではワークロードが中断されますが、他のゾーンで引き続き実行可能です。

コントロールプレーンの可用性を高めるには、これらに代えてリージョンクラスタを作成することを検討してください。リージョンクラスタでは、コントロールプレーンがリージョン内の複数のゾーンに複製されます。

始める前に

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

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: 新しいクラスタの名前。
CHANNEL: リリースチャネルのタイプ。rapid、regular、stable、None のいずれかに指定できます。--cluster-version、--release-channel、--no-enable-autoupgrade、--no-enable-autorepair のうち少なくとも 1 つのフラグが指定されていない限り、デフォルトではクラスタは regular リリースチャネルに登録されます。
COMPUTE_ZONE: クラスタコントロールプレーンのコンピューティングゾーン。
VERSION: クラスタに指定するバージョン。
COMPUTE_ZONE,COMPUTE_ZONE1,[...]: ノードが作成されるゾーン。クラスタに必要な数だけゾーンを指定できます。すべてのゾーンは、--zone フラグで指定された、クラスタのコントロールプレーンと同じリージョンに存在する必要があります。ゾーンクラスタの場合、--node-locations にはクラスタのプライマリゾーンが含まれている必要があります。

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

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

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

gcloud container clusters create CLUSTER_NAME \
    --release-channel CHANNEL \
    --zone COMPUTE_ZONE \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

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

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

gcloud container clusters create CLUSTER_NAME \
    --cluster-version VERSION \
    --zone COMPUTE_ZONE \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

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

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

gcloud container clusters create CLUSTER_NAME \
    --release-channel None \
    --zone COMPUTE_ZONE \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

例

次のコマンドは、example-cluster という名前のマルチゾーンクラスタを作成します。クラスタコントロールプレーンは us-central-a ゾーンにあり、3 つのノードのロケーションがあります。クラスタは、regular リリースチャンネルに登録されます。

--num-nodes フラグを省略した場合、クラスタがデフォルトでゾーンごとに作成するノードの数は 3 つです。ゾーンが 3 つ指定されているため、このコマンドは us-central1-a、us-central1-b、us-central1-c のそれぞれにノードが 3 つずつ含まれる、9 ノードのクラスタを作成します。

gcloud container clusters create example-cluster \
    --zone us-central1-a \
    --node-locations us-central1-a,us-central1-b,us-central1-c

コンソール

Google Cloud コンソールでゾーンクラスタを作成するには、次のタスクを実行します。

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-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1

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

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 は以前、クラスタのテンプレートをサポートしていました。これらのテンプレートは Google Cloud コンソールからは削除されましたが、現在も次のリンクからアクセスできます。

最初のクラスタ
注: GKE には、最初のクラスタのチュートリアルが用意されています。
CPU 使用率の高いアプリケーション
メモリ使用量の多いアプリケーション
GPU による高速コンピューティング
高可用性

次のステップ

作成可能なクラスタ構成の選択肢について確認する。
GKE クラスタのアーキテクチャについて学習する。
クラスタの管理について学習する。
クラスタを削除する方法を学習する。

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオで GKE のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

GKE の無料トライアル