ゾーンクラスタの作成

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

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

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

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

始める前に

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

  • Google Kubernetes Engine API を有効にする。
  • Google Kubernetes Engine API を有効化
  • このタスクに Google Cloud CLI を使用する場合は、gcloud CLI をインストールして初期化します。gcloud CLI をインストール済みの場合は、gcloud components update コマンドを実行して最新のバージョンを取得します。以前のバージョンの gcloud CLI では、このドキュメントのコマンドを実行できない場合があります。
  • クラスタを作成するための適切な権限があることを確認する。少なくとも、Kubernetes Engine Cluster 管理者である必要があります。
  • 新しいクラスタをフリートに登録する場合は、必要な API と権限があることを確認してください。

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

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

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

コンソール

  1. [ようこそ] ページに移動します。

    [ようこそ] に移動

  2. [プロジェクト番号] フィールドで、 [クリップボードにコピー] をクリックします。
  3. [IAM] ページに移動します。

    [IAM] に移動

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

gcloud

  1. Google Cloud プロジェクト番号を確認します。
    gcloud projects describe PROJECT_ID \
        --format="value(projectNumber)"

    PROJECT_ID は、実際のプロジェクト ID に置き換えます。

    出力は次のようになります。

    12345678901
    
  2. 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(非推奨)のいずれかに指定できます。デフォルトでは、クラスタは 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

例

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

--num-nodes フラグを省略した場合、クラスタがデフォルトでゾーンごとに作成するノードの数は 3 つです。3 つのゾーンが指定されているため、このコマンドは us-east4-a、us-east4-b、us-east4-c にそれぞれ 3 つのノードを持つ 9 ノードのクラスタを作成します。GKE バージョン 1.37.1-gke.1153000 以降では、--num-nodes フラグを 0 の値に設定して、ノードがゼロのクラスタを作成できます。

gcloud container clusters create example-cluster \
    --location us-east4-a \
    --node-locations us-east4-a,us-east4-b,us-east4-c

コンソール

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

  1. Google Cloud コンソールで、[Kubernetes クラスタを作成する] ページに移動します。

    [Kubernetes クラスタの作成] に移動

  2. [クラスタの基本] セクションで、次の操作を行います。

    1. クラスタの名前を [名前] に入力します。
    2. [ロケーション タイプ] には [ゾーン] を選択し、クラスタに使用するゾーンを選択します。
    3. マルチゾーン クラスタを作成する場合は、[デフォルトのノードのロケーションを指定する] チェックボックスをオンにして、ノードプールを実行する追加のゾーンを選択します。

    4. リリース チャンネルを選択します。必要に応じて [チャンネルなし] を選択できますが、この構成オプションは非推奨であり、削除される予定です。詳細については、リリース チャンネルに登録されていないクラスタをご覧ください。

    5. 省略可: [バージョン] プルダウン リストからコントロール プレーンのバージョンを指定します。

  3. 省略可: 新しいクラスタの他の設定を構成します。

  4. 省略可: 新しいクラスタをフリートに登録する場合は、[詳細設定] セクションに移動し、 Google Cloud コンソールで新しいクラスタを作成して登録するの手順に沿ってクラスタの登録を完了します。

  5. 独自のノードプールを作成して構成する手順は次のとおりです。

    1. [ノードプールを追加] をクリックします。
    2. [変更が必要です] ダイアログで [変更を適用] をクリックします。

    ナビゲーション メニューに、default-pool という名前のノードプールが表示されます。

  6. 省略可: ノードプールのないクラスタを作成するには、次の操作を行います。

    1. ナビゲーション メニューで [default-pool] をクリックします。
    2. [ ノードプールを削除] をクリックします。
    3. クラスタの残りの設定を構成し、[作成] をクリックします。
  7. 省略可: クラスタにノードプールを追加するには、[ ノードプールを追加] をクリックします。ナビゲーション メニューに新しいノードプールが表示されます。

  8. ノードプールの基本設定を構成します。

    1. ナビゲーション メニューの [ノードプール] セクションで、ノードプールの名前をクリックします。[ユーザー管理のノードプールの詳細] ページが開きます。
    2. [名前] フィールドに、ノードプールの名前を入力します。
    3. [サイズ] セクションの [ノード数] フィールドに、作成するノード数を指定します。ノードとそのリソース(ファイアウォール ルートなど)に使用できるリソース割り当てが必要です。GKE バージョン 1.37.1-gke.1153000 以降では、0 の値を指定して空のノードプールを作成できます。
  9. ノードを実行する VM インスタンスの設定を構成します。

    1. ナビゲーション メニューで、選択したノードプールの展開されたセクションの [ノード] をクリックします。
    2. [イメージの種類] プルダウン リストから、ノードイメージを選択します。
    3. インスタンスに使用するデフォルトのマシンの構成を選択します。マシンタイプごとに課金方法は異なります。デフォルトのマシンタイプは e2-medium です。マシンタイプごとの料金については、マシンタイプの料金表をご覧ください。
    4. [ブートディスクの種類] プルダウン リストから、ディスクの種類を選択します。
    5. [ブートディスクのサイズ] フィールドに、ブートディスクのサイズを GB 単位で指定します。
  10. ノードプールのセキュリティ設定を構成します。

    1. ナビゲーション メニューで、選択したノードプールの展開されたセクションの [セキュリティ] をクリックします。
    2. 必要に応じて、ノードにカスタム IAM サービス アカウントを指定します。
      1. [詳細設定] ページで、[セキュリティ] セクションを開きます。
      2. [サービス アカウント] メニューで、目的のサービス アカウントを選択します。

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

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

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 バージョン 1.37.1-gke.1153000 以降では、次のいずれかの方法でノードがゼロのゾーンクラスタを作成できます。

  • デフォルトのノードプールの作成をスキップする: GKE はクラスタにノードプールを追加しません。Autopilot ComputeClass、ノードプールの自動作成、または後で作成するカスタム ノードプールを使用してワークロードを実行する場合は、このオプションを使用します。
  • 空のノードプールを作成する: GKE は、ノードがゼロのノードプールを作成します。実際のノードを作成せずに、クラスタの作成時にノードプールの設定をカスタマイズする場合は、このオプションを使用します。

ノードが 0 のクラスタを作成すると、クラスタに少なくとも 1 つのノードが存在するまで、システム Pod はスケジュール不可の状態のままになります。ノードがゼロのゾーンクラスタを作成するには、次のいずれかのオプションを選択します。

gcloud

  • デフォルトのノードプールの作成をスキップするには、gcloud container clusters create コマンドで --num-nodes=0 フラグのみを使用します。

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0
    

    次のように置き換えます。

    • CLUSTER_NAME: 新しいゾーンクラスタの名前。
    • CONTROL_PLANE_LOCATION: クラスタのコントロール プレーンの Compute Engine ゾーン(us-central1-a など)。

    --machine-type、--disk-type、--disk-size フラグなどの他のノードプール構成フラグを指定すると、GKE が構成するノードプールがないため、コマンドは失敗します。

  • 空のノードプールを持つクラスタを作成するには、gcloud container clusters create コマンドで --num-nodes=0 フラグと --node-pool-name フラグを使用します。

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0 \
        --node-pool-name=NODEPOOL_NAME
    

    NODEPOOL_NAME は、空のノードプールの名前に置き換えます。他のノード構成フラグを指定して、空のノードプール内のノードをカスタマイズできます。

コンソール

  1. Google Cloud コンソールで、[Kubernetes クラスタを作成する] ページに移動します。

    [Kubernetes クラスタの作成] に移動

  2. クラスタの名前を指定します。

  3. [ロケーション タイプ] セクションで、[ゾーン] を選択します。

  4. [ゾーン] プルダウン リストで、クラスタのコントロール プレーンのゾーンを選択します。

  5. デフォルトのノードプールの作成をスキップするか、空のノードプールを作成します。

    • デフォルトのノードプールの作成をスキップするには、[デフォルト モード] セクションで [Autopilot] オプションが選択されていることを確認します。または、デフォルトのノードプールの作成をトリガーしてから削除します。

      1. [ノードプールを追加] をクリックします。
      2. [変更が必要です] ダイアログで [変更を適用] をクリックします。default-pool という名前のノードプールが表示されます。
      3. ナビゲーション メニューで [default-pool] をクリックします。
      4. [ ノードプールを削除] をクリックします。

      これらの手順では、ノードプールがなく、Autopilot モードを使用して ComputeClass を選択しないワークロードを実行するクラスタを作成します。Autopilot モードの使用を防止するには、[デフォルト モード] セクションで [ユーザー管理ノードプール] オプションを選択します。

    • 空のノードプールを作成する手順は次のとおりです。

      1. [ノードプールを追加] をクリックします。
      2. [変更が必要です] ダイアログで [変更を適用] をクリックします。default-pool という名前のノードプールが表示されます。
      3. ナビゲーション メニューで [default-pool] をクリックします。
      4. [ノード数] フィールドに、0 の値を指定します。
  6. クラスタの残りの設定を構成し、[作成] をクリックします。

Terraform

  • デフォルトのノードプールの作成をスキップするには、google_container_cluster リソースで initial_node_count フィールドの値を 0 に設定します。
  • 空の初期ノードプールを作成するには、次の操作を行います。

    1. google_container_cluster リソースで、initial_node_count フィールドを 0 の値に設定します。
    2. google_container_node_pool リソースを追加し、node_count フィールドを 0 の値に設定します。

ノードがゼロのクラスタを作成したら、次の方法でノードをプロビジョニングできます。

クラスタ テンプレート

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

次のステップ

使ってみる

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

GKE の無料トライアル