このページは Cloud Translation API によって翻訳されました。

ノードプールを管理する

共有標準

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

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

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

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

始める前に

このドキュメントのタスクを完了するには、次のリソースとロールが必要です。

共有 Kubernetes クラスタでノードプールを表示して管理するには、組織の IAM 管理者に次のロールの付与を依頼してください。
- ユーザークラスタ管理者（user-cluster-admin）
- ユーザークラスタノード閲覧者（user-cluster-node-viewer）
これらのロールは Namespace にバインドされていません。
標準 Kubernetes クラスタでノードプールを表示して管理するには、組織の IAM 管理者に Standard Cluster 管理者（standard-cluster-admin）ロールの付与を依頼してください。このロールはプロジェクトの Namespace にバインドされます。
Kubernetes クラスタに対してコマンドを実行するには、次のリソースがあることを確認してください。
- Kubernetes クラスタ名を確認するか、プラットフォーム管理者グループのメンバーにクラスタ名を確認します。
- まだ Kubernetes クラスタの kubeconfig ファイルがない場合は、ログインして生成します。
- Kubernetes クラスタの kubeconfig パスを使用して、これらの手順の KUBERNETES_CLUSTER_KUBECONFIG を置き換えます。

ノードプールを追加する

既存の 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 パス。ターゲットゾーンの API サーバーの kubeconfig ファイルをまだ生成していない場合は、ログインをご覧ください。
nodePools セクションに新しいエントリを追加します。
```
nodePools:
...
- 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 クラスタ内の既存のノードプールを表示する手順は次のとおりです。

コンソール

ナビゲーションメニューで、[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 クラスタ内のノードプールのサイズは、プールをスケールアップまたはスケールダウンすることで手動で変更できます。ノードプールをスケールダウンするときに、削除する特定のノードを選択することはできません。

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

コンソール

ダッシュボードで、編集するクラスタが存在するプロジェクトを選択します。
ナビゲーションメニューで、[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 パス。ターゲットゾーンの API サーバーの kubeconfig ファイルを生成していない場合は、ゾーン Management API サーバーリソースをご覧ください。
サイズ変更するノードプールの 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 つ以上あることを確認してください。

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

コンソール

ナビゲーションメニューで、[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 パス。ターゲットゾーンの API サーバーの kubeconfig ファイルを生成していない場合は、ゾーン Management API サーバーリソースをご覧ください。
nodePools セクションからノードプールのエントリを削除します。たとえば、次のスニペットでは、machineTypeName、name、nodeCount の各フィールドを削除する必要があります。
```
nodePools:
# Several lines of code are omitted here.
- machineTypeName: n2-standard-2-gdc
  name: nodepool-1
  nodeCount: 3
```
削除するノードプールのすべてのフィールドを削除してください。
ファイルを保存し、エディタを終了します。

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

始める前に

ノードプールを追加する

コンソール

API

ノードプールを表示する

コンソール

API

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

コンソール

API

ノードプールの削除

コンソール

API

ノードプールを管理する