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

ノードプールを管理する

共有 Standard

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

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

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

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

始める前に

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

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

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

共有クラスタのロール

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

Standard クラスタのロール

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

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

これらのロールは、プロジェクトの名前空間にバインドされています。

環境を準備する

API を使用して Kubernetes クラスタに対してコマンドを実行するには、次のリソースが必要です。

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

ノードプールを追加する

既存の 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: クラスタの名前空間。共有クラスタの場合は、platform 名前空間を使用します。Standard クラスタの場合は、クラスタのプロジェクトの名前空間を使用します。
- 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: クラスタの名前空間。共有クラスタの場合は、platform 名前空間を使用します。Standard クラスタの場合は、クラスタのプロジェクトの名前空間を使用します。

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

[
  {
    "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: クラスタの名前空間。共有クラスタの場合は、platform 名前空間を使用します。Standard クラスタの場合は、クラスタのプロジェクトの名前空間を使用します。
- 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 の数が、ノードプールに設定したノード数を反映していることを確認します。ノードプールが指定したサイズにスケーリングされるまでに数分かかることがあります。

ノードプールを削除する

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

ノードプールを削除する前に、クラスタに 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: クラスタの名前空間。共有クラスタの場合は、platform 名前空間を使用します。Standard クラスタの場合は、クラスタのプロジェクトの名前空間を使用します。
- 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 ロールをリクエストする

共有クラスタのロール

Standard クラスタのロール

環境を準備する

ノードプールを追加する

コンソール

API

ノードプールを表示する

コンソール

API

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

コンソール

API

ノードプールを削除する

コンソール

API

次のステップ

ノードプールを管理する