ゾーンクラスタの作成

Standard

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

ベストプラクティス: 本番環境ワークロードを実行するにはリージョンクラスタを使用します。リージョンクラスタの方がゾーンクラスタと比較して可用性に優れているためです。リージョンクラスタでは、コントロールプレーンがリージョン内の複数のゾーンに複製されます。

クラスタを作成した後は、それをゾーンクラスタからリージョンクラスタに、またはリージョンクラスタからゾーンクラスタに変更することはできません。クラスタの可用性のタイプについては、クラスタの可用性をご覧ください。

このページは、クラスタの作成と構成、GKE へのワークロードのデプロイが必要なオペレーター、Cloud Architect、デベロッパーを対象としています。 Google Cloudのコンテンツで参照する一般的なロールとタスク例の詳細については、一般的な GKE Enterprise ユーザーロールとタスクをご覧ください。

このページを読む前に、クラスタ構成の選択肢について理解しておいてください。

始める前に

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

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 ロールを付与する手順は次のとおりです。

コンソール

[ようこそ] ページに移動します。
[ようこそ] に移動
[プロジェクト番号] フィールドで、 [クリップボードにコピー] をクリックします。
[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 container clusters create と Terraform google_container_cluster リファレンスガイドをご覧ください。

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 リリースチャネルに登録されます。
CONTROL_PLANE_LOCATION: クラスタのコントロールプレーンの Compute Engine のゾーン。
VERSION: クラスタに指定するバージョン。
COMPUTE_ZONE,COMPUTE_ZONE1,[...]: ノードが作成されるゾーン。クラスタに必要な数だけゾーンを指定できます。すべてのゾーンは、--location フラグで指定された、クラスタのコントロールプレーンと同じリージョンに存在する必要があります。ゾーンクラスタの場合、--node-locations にはクラスタのプライマリゾーンが含まれている必要があります。

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

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

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

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

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

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

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

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

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

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

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

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

gcloud container clusters create CLUSTER_NAME \
    --release-channel None \
    --location CONTROL_PLANE_LOCATION \
    --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 \
    --location us-central1-a \
    --node-locations us-central1-a,us-central1-b,us-central1-c

コンソール

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

Google Cloud コンソールで、[Kubernetes クラスタを作成する] ページに移動します。
[Kubernetes クラスタの作成] に移動
[クラスタの基本] セクションで、次の操作を行います。
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-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1
}

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

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

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

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

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

クラスタテンプレート

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

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

次のステップ

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

使ってみる

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

GKE の無料トライアル

ゾーンクラスタの作成 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

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

コンソール

gcloud

ゾーンクラスタを作成する

gcloud

コンソール

Terraform

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

クラスタ テンプレート

次のステップ

使ってみる

ゾーンクラスタの作成

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

クラスタテンプレート