スケジューリングを構成する

このページでは、スケジューラ オプションと、ベアメタル クラスタ用の Google Distributed Cloud ソフトウェアのみでデフォルトの Pod スケジューリング制約を構成する方法について説明します。

Google Distributed Cloud には、Pod のスケジューリングを制御するために使用できる、次のような標準の Kubernetes 機能が用意されています。

Kubernetes の Pod トポロジの分散制約については、Kubernetes ドキュメントの Kubernetes Scheduler をご覧ください。

始める前に

デフォルトの Pod 分散を構成する前に、クラスタ内の各ノードに正しいトポロジラベルがあることを確認してください。Nodepool.Spec.TaintsAndLabels API を使用してラベルを適用できます。kubectl label を使用してノードに手動でラベルを付けると、柔軟性が向上しますが、クラスタに新しいノードを追加するときに手動でラベルを付ける必要があります。

デフォルトのカスタム スケジューラを構成する {#:config-default}

ノードにラベルを付ける

  1. クラスタとノードプールの YAML ファイルにトポロジラベルを追加します。次の例では、2 つのワーカー ノードプールが異なるラックにあり、コントロール プレーン ノードが rack1 にあると想定しています。

    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: abm-cluster
      namespace: cluster-abm-cluster
    spec:
      controlPlane:
        nodePoolSpec:
          labels:
            topology.k8s.io/rack: rack1
    ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: NodePool
    metadata:
      name: nodepool-rack1
      namespace: cluster-abm-cluster
    spec:
      labels:
        topology.k8s.io/rack: rack1
    ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: NodePool
    metadata:
      name: nodepool-rack2
      namespace: cluster-abm-cluster
    spec:
      labels:
        topology.k8s.io/rack: rack2
    
  2. 更新されたクラスタ構成を適用します。

    bmctl update cluster -c CLUSTER_NAME
    

    CLUSTER_NAME は、使用するクラスタの名前に置き換えます。

  3. topology.k8s.io/rack ラベルがクラスタ内のすべてのノードに伝播されるまで待ちます。

デフォルトの Pod 分散制約を有効にする

  1. preview.baremetal.cluster.gke.io/custom-scheduler-configuration:enable アノテーションをクラスタの YAML ファイルに追加します。

  2. クラスタの YAML ファイルの cluster.spec.controlPlane の下に schedulerConfiguration セクションを追加します。

    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: abm-cluster
      namespace: cluster-abm-cluster
      annotations:
        preview.baremetal.cluster.gke.io/custom-scheduler-configuration: enable
    spec:
      controlPlane:
        schedulerConfiguration:
          defaultTopologySpreadConstraint:
            defaultConstraints:
            - topologyKey: topology.k8s.io/rack
              whenUnsatisfiable: DoNotSchedule
              maxSkew: 1
            defaultingType: List
    
  3. 更新されたクラスタ構成を適用します。

    bmctl update cluster -c CLUSTER_NAME
    

    CLUSTER_NAME は、使用するクラスタの名前に置き換えます。

  4. クラスタの調整が完了するまで待ちます。cluster.status.clusterState が Running になるまでモニタリングします。このプロセス中に、各コントロール プレーン ノードに対して control-plane-update ジョブが実行されます。

Pod の分散構成を確認する

  1. 5 つのレプリカを含むテスト デプロイを作成します。

  2. Pod の分散を確認します。nodepool-rack1 と nodepool-rack2 の Pod 数の差は 1 にする必要があります。

  3. 各コントロール プレーン ノードで kube-scheduler-profile.config ファイルを確認します。/etc/kubernetes/kube-scheduler-profile.config にあるファイルには、cluster.spec のトポロジ スプレッド構成が含まれている必要があります。

トラブルシューティング

デフォルトの Pod 分散に関する問題を診断して解決するには、次の点を確認してください。

  1. BareMetalMachine.Status.ControlPlaneComponents で機能のステータスを確認します。
  2. cluster-operator と cap-controller-manager のログで、関連するイベントを調べます。
  3. kube-scheduler 静的 Pod がクラッシュした場合は、クラスタ YAML ファイルでスケジューラ構成が正しいことを確認します。

次のステップ