Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ノードプールを管理する

共有標準

Google Distributed Cloud（GDC）エアギャップ Kubernetes クラスタを作成すると、指定したノード数とノードタイプでクラスタの最初のノードプールが作成されます。コンピューティング要件の変更に応じて、既存のクラスタに対して次のノードプールタスクを実行できます。

新しいノードプールを追加する: クラスタワークロードの需要が増加するにつれて、新しいノードプールを追加します。
ノードプールを表示する: 既存のノードプールの特性と状態を表示します。
ノードプールのサイズを変更する: ワークロードトラフィックの変動に合わせて、ノードプールを手動でスケールアップまたはスケールダウンします。
ノードプールを削除する: クラスタワークロードの需要が減少した場合や、コンテナオペレーションに不要になったマシンタイプを削除する場合は、ノードプールを削除します。

クラスタ内のノードプールの詳細については、ノードについてをご覧ください。

このドキュメントは、アプリケーションオペレーターグループ内のアプリケーションデベロッパーと、組織内の Kubernetes クラスタの管理を担当するプラットフォーム管理者グループ内の IT 管理者を対象としています。詳細については、GDC エアギャップドキュメントの対象読者をご覧ください。

始める前に

このドキュメントのタスクを完了するには、必要な権限をリクエストして環境を準備する必要があります。

IAM ロールをリクエストする

Kubernetes クラスタでノードプールを管理するために必要な権限を取得するには、特定のロールが必要です。必要なロールは、組織スコープの共有クラスタとプロジェクトスコープの標準クラスタのどちらで作業しているかによって異なります。詳細については、Kubernetes クラスタの構成をご覧ください。

共有クラスタロール

共有クラスタのノードプールを作成、削除、編集、表示するには、IAM 組織管理者に連絡して、ユーザークラスタ管理者（user-cluster-admin）ロールをリクエストしてください。このロールは Namespace にバインドされていません。

標準クラスタロール

IAM プロジェクト管理者に連絡して、次のロールをリクエストしてください。

標準クラスタ管理者（standard-cluster-admin）: 標準クラスタのノードプールの作成、削除、編集、表示。
クラスタデベロッパー（cluster-developer）: 標準クラスタを作成、削除、編集、表示します。このロールは、GDC コンソールからクラスタのノードプールの詳細を表示するために必要です。

これらのロールは、プロジェクトの Namespace にバインドされます。

環境を準備する

API を使用して Kubernetes クラスタに対してコマンドを実行するには、次のリソースがあることを確認してください。

Kubernetes クラスタ名を確認するか、プラットフォーム管理者グループのメンバーにクラスタ名を確認します。
これらの手順では、KUBERNETES_CLUSTER_NAME を Kubernetes クラスタ名に置き換えます。
Kubernetes クラスタの Management API サーバーの kubeconfig ファイルにログインして生成します。
これらの手順では、MANAGEMENT_API_SERVER を管理 API サーバーの kubeconfig パスに置き換えます。

ノードプールを追加する

既存の Kubernetes クラスタにノードプールを追加する手順は次のとおりです。

コンソール

プロジェクト選択ツールで、プロジェクトまたは組織を選択します。

Standard クラスタはプロジェクトスコープで、共有クラスタは組織スコープです。適切な Kubernetes クラスタタイプを表示するには、適切なスコープを選択します。
ナビゲーションメニューで、[Kubernetes Engine] > [クラスタ] を選択します。
クラスタリストからクラスタをクリックします。[クラスタの詳細] ページが表示されます。
[ノードプール] > [ノードプールを追加] を選択します。
ノードプールの名前を割り当てます。ノードプールの作成後に名前を変更することはできません。
ノードプールに作成するワーカーノードの数を指定します。
ワークロードの要件に最も適したマシンのクラスを選択します。マシンクラスは次の設定に表示されます。
- マシンタイプ
- vCPU
- メモリ
[保存] をクリックします。

API

インタラクティブエディタを使用して、kubectl CLI で Cluster カスタムリソース仕様を開きます。
```
kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER
```
次のように置き換えます。
- KUBERNETES_CLUSTER_NAME: クラスタの名前。
- KUBERNETES_CLUSTER_NAMESPACE: クラスタの Namespace。共有クラスタの場合は、platform Namespace を使用します。標準クラスタの場合は、クラスタのプロジェクト Namespace を使用します。
- MANAGEMENT_API_SERVER: Kubernetes クラスタがホストされているゾーン API サーバーの kubeconfig パス。
nodePools セクションに新しいエントリを追加します。
```
nodePools:
# Several lines of code are omitted here.
- machineTypeName: MACHINE_TYPE
  name: NODE_POOL_NAME
  nodeCount: NUMBER_OF_WORKER_NODES
  taints: TAINTS
  labels: LABELS
  acceleratorOptions:
    gpuPartitionScheme: GPU_PARTITION_SCHEME
```
次のように置き換えます。
- MACHINE_TYPE: ノードプールのワーカーノードのマシンタイプ。構成可能なマシンタイプについては、使用可能なマシンタイプをご覧ください。
- NODE_POOL_NAME: ノードプールの名前。
- NUMBER_OF_WORKER_NODES: ノードプールにプロビジョニングするワーカーノードの数。
- TAINTS: このノードプールのノードに適用する taint。このフィールドは省略できます。
- LABELS: このノードプールのノードに適用するラベル。Key-Value ペアのリストが含まれます。このフィールドは省略できます。
- GPU_PARTITION_SCHEME: GPU ワークロードを実行している場合の GPU パーティショニングスキーム。例: mixed-2このフィールドが設定されていない場合、GPU はパーティショニングされません。使用可能なマルチインスタンス GPU（MIG）プロファイルについては、サポートされている MIG プロファイルをご覧ください。
注: ノードプールの作成後に、GPU パーティショニングなどのノード構成を編集することはできません。
ファイルを保存し、エディタを終了します。

ノードプールを表示する

Kubernetes クラスタ内の既存のノードプールを表示する手順は次のとおりです。

コンソール

プロジェクト選択ツールで、プロジェクトまたは組織を選択します。

Standard クラスタはプロジェクトスコープで、共有クラスタは組織スコープです。適切な Kubernetes クラスタタイプを表示するには、適切なスコープを選択します。
ナビゲーションメニューで、[Kubernetes Engine] > [クラスタ] を選択します。
クラスタリストからクラスタをクリックします。[クラスタの詳細] ページが表示されます。
[ノードプール] を選択します。

クラスタで実行されているノードプールのリストが表示されます。このページからクラスタのノードプールを管理できます。

API

特定の Kubernetes クラスタのノードプールを表示します。

kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    -o json --kubeconfig MANAGEMENT_API_SERVER | \
    jq .status.workerNodePoolStatuses

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

KUBERNETES_CLUSTER_NAME: クラスタの名前。
KUBERNETES_CLUSTER_NAMESPACE: クラスタの Namespace。共有クラスタの場合は、platform Namespace を使用します。標準クラスタの場合は、クラスタのプロジェクト Namespace を使用します。

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

[
  {
    "conditions": [
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "NodepoolReady",
        "status": "True",
        "type": "Ready"
      },
      {
        "lastTransitionTime": "2023-08-31T22:16:17Z",
        "message": "",
        "observedGeneration": 2,
        "reason": "ReconciliationCompleted",
        "status": "False",
        "type": "Reconciling"
      }
    ],
    "name": "worker-node-pool",
    "readyNodes": 3,
    "readyTimestamp": "2023-08-31T18:59:46Z",
    "reconcilingNodes": 0,
    "stalledNodes": 0,
    "unknownNodes": 0
  }
]

ノードプールのサイズを変更する

Kubernetes クラスタ内のノードプールのサイズは、プールのアップスケールまたはダウンスケールによって手動で変更できます。ノードプールをダウンスケーリングするときに、削除する特定のノードを選択することはできません。

既存のクラスタでノードプールをスケーリングする手順は次のとおりです。

コンソール

プロジェクト選択ツールで、プロジェクトまたは組織を選択します。

Standard クラスタはプロジェクトスコープで、共有クラスタは組織スコープです。適切な Kubernetes クラスタタイプを表示するには、適切なスコープを選択します。
ダッシュボードで、編集するクラスタが存在するプロジェクトを選択します。
ナビゲーションメニューで、[Kubernetes Engine] > [クラスタ] を選択します。
ノードプールが関連付けられているクラスタ名を選択します。[クラスタの詳細] ページが表示されます。
[ノードプール] タブをクリックします。
サイズを変更するノードプールの編集アイコンを選択します。[ノードプールの編集] プロンプトが表示されます。
[ノード数] フィールドを更新して、ノードプールに必要な新しいノード数を反映します。ワークロードの要件に合わせてノード数を増減できます。

注: 残りのノードに既存のワークロードを処理するのに十分なメモリがない場合、ノードプールをダウンスケーリングするとリソースの問題が発生する可能性があります。
[保存] をクリックします。
クラスタの [ノードプール] タブに戻り、サイズ変更されたノードプールのステータスが Ready で、ノード数が正しいことを確認します。ノードプールが仕様に合わせてスケーリングされるまでに数分かかることがあります。

API

インタラクティブエディタを使用して、kubectl CLI で Cluster カスタムリソース仕様を開きます。
```
kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER
```
次のように置き換えます。
- KUBERNETES_CLUSTER_NAME: ノードプールをホストするクラスタの名前。
- KUBERNETES_CLUSTER_NAMESPACE: クラスタの Namespace。共有クラスタの場合は、platform Namespace を使用します。標準クラスタの場合は、クラスタのプロジェクト Namespace を使用します。
- MANAGEMENT_API_SERVER: Kubernetes クラスタがホストされているゾーン API サーバーの kubeconfig パス。
サイズを変更するノードプールの nodeCount フィールドを更新します。
```
nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: NUMBER_OF_WORKER_NODES
```
NUMBER_OF_WORKER_NODES は、ノードプールにプロビジョニングするワーカーノードの更新後の数に置き換えます。
ファイルを保存し、エディタを終了します。
ノードプールの構成を確認して、ノードのスケーリングが完了していることを確認します。
```
kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE -o json \
    --kubeconfig MANAGEMENT_API_SERVER | jq .status.workerNodePoolStatuses
```
readyNodes の数が、ノードプールに設定したノードの数を反映していることを確認します。ノードプールが仕様に合わせてスケーリングされるまでに数分かかることがあります。

ノードプールの削除

ノードプールを削除すると、ノードとそのノードへのルートが削除されます。これらのノードは、実行中の Pod を強制排除して再スケジュールします。Pod に特定のノードセレクタが設定されており、クラスタ内の他のノードが条件を満たさない場合、その Pod はスケジュールできない状態のままになることがあります。

ノードプールを削除する前に、ワーカーノードが 3 つ以上あることを確認してください。これにより、クラスタに十分なコンピューティングスペースが確保され、効果的に実行できるようになります。

ノードプールを削除するには、次の手順を行います。

コンソール

プロジェクト選択ツールで、プロジェクトまたは組織を選択します。

Standard クラスタはプロジェクトスコープで、共有クラスタは組織スコープです。適切な Kubernetes クラスタタイプを表示するには、適切なスコープを選択します。
ナビゲーションメニューで、[Kubernetes Engine] > [クラスタ] を選択します。
削除するノードプールをホストしているクラスタをクリックします。
[ノードプール] を選択します。
削除するノードプールの横にある [削除] をクリックします。

API

インタラクティブエディタを使用して、kubectl CLI で Cluster カスタムリソース仕様を開きます。
```
kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
    -n KUBERNETES_CLUSTER_NAMESPACE \
    --kubeconfig MANAGEMENT_API_SERVER
```
次のように置き換えます。
- KUBERNETES_CLUSTER_NAME: クラスタの名前。
- KUBERNETES_CLUSTER_NAMESPACE: クラスタの Namespace。共有クラスタの場合は、platform Namespace を使用します。標準クラスタの場合は、クラスタのプロジェクト Namespace を使用します。
- MANAGEMENT_API_SERVER: Kubernetes クラスタがホストされているゾーン API サーバーの kubeconfig パス。
nodePools セクションからノードプールエントリを削除します。たとえば、次のスニペットでは、machineTypeName、name、nodeCount フィールドを削除する必要があります。
```
nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: 3
```
削除するノードプールのすべてのフィールドを削除してください。
ファイルを保存し、エディタを終了します。

ノードプールを管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

IAM ロールをリクエストする

共有クラスタロール

標準クラスタロール

環境を準備する

ノードプールを追加する

コンソール

API

ノードプールを表示する

コンソール

API

ノードプールのサイズを変更する

コンソール

API

ノードプールの削除

コンソール

API

次のステップ

ノードプールを管理する