Configurer la planification

Cette page décrit les options du programmeur et explique comment configurer les contraintes de planification des pods par défaut dans vos clusters Google Distributed Cloud (logiciel uniquement) sur Bare Metal.

Google Distributed Cloud fournit un certain nombre de fonctionnalités Kubernetes standards que vous pouvez utiliser pour contrôler la planification des pods, par exemple :

Pour en savoir plus sur les contraintes de répartition de la topologie des pods dans Kubernetes, consultez Kubernetes Scheduler dans la documentation Kubernetes.

Avant de commencer

Avant de configurer la répartition des pods par défaut, assurez-vous que chaque nœud de votre cluster possède les étiquettes de topologie appropriées. Vous pouvez utiliser l'API Nodepool.Spec.TaintsAndLabels pour appliquer des libellés. L'ajout manuel d'étiquettes aux nœuds avec kubectl label offre plus de flexibilité, mais nécessite un ajout manuel d'étiquettes lorsque vous ajoutez un nœud au cluster.

Configurer le planificateur personnalisé par défaut {#:config-default}

Ajouter des étiquettes aux nœuds

  1. Ajoutez des étiquettes de topologie aux fichiers YAML de votre cluster et de votre pool de nœuds. L'exemple suivant suppose que deux pools de nœuds de calcul se trouvent dans des racks différents et que les nœuds du plan de contrôle se trouvent dans 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. Appliquez la configuration de cluster mise à jour.

    bmctl update cluster -c CLUSTER_NAME
    

    Remplacez CLUSTER_NAME par le nom de votre cluster.

  3. Attendez que l'étiquette topology.k8s.io/rack se propage à tous les nœuds du cluster.

Activer les contraintes de répartition des pods par défaut

  1. Ajoutez l'annotation preview.baremetal.cluster.gke.io/custom-scheduler-configuration:enable au fichier YAML de votre cluster.

  2. Ajoutez la section schedulerConfiguration sous cluster.spec.controlPlane dans le fichier YAML de votre cluster.

    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. Appliquez la configuration de cluster mise à jour.

    bmctl update cluster -c CLUSTER_NAME
    

    Remplacez CLUSTER_NAME par le nom de votre cluster.

  4. Attendez que le rapprochement du cluster soit terminé. Surveillez cluster.status.clusterState jusqu'à ce qu'il affiche Running. Un job control-plane-update s'exécute pour chaque nœud du plan de contrôle au cours de ce processus.

Vérifier la configuration de la répartition des pods

  1. Créez un déploiement de test avec cinq instances répliquées.

  2. Observez la répartition des pods. La différence entre le nombre de pods sur nodepool-rack1 et nodepool-rack2 doit être d'exactement un.

  3. Vérifiez le fichier kube-scheduler-profile.config sur chaque nœud du plan de contrôle. Le fichier, situé à l'emplacement /etc/kubernetes/kube-scheduler-profile.config, doit contenir la configuration de répartition de la topologie de cluster.spec.

Résoudre les problèmes

Pour diagnostiquer et résoudre les problèmes liés à la répartition par défaut des pods, vérifiez les points suivants :

  1. Consultez la BareMetalMachine.Status.ControlPlaneComponents pour connaître l'état de la fonctionnalité.
  2. Examinez les journaux de cluster-operator et cap-controller-manager pour détecter les événements pertinents.
  3. Si les pods statiques kube-scheduler plantent, vérifiez que la configuration du programmeur est correcte dans le fichier YAML du cluster.

Étapes suivantes