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

ノードプールを管理する

共有標準

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

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

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

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

始める前に

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

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

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

共有クラスタロール

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

標準クラスタロール

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

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

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

環境を準備する

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: クラスタの 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

次のステップ

ノードプールを管理する