Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

Relations entre les ressources du cluster dans SUSE® Rancher Prime Cluster API

Présentation

Rancher intègre plusieurs composants qui définissent leurs propres Cluster ressources personnalisées. SUSE® Rancher Prime Cluster API s’appuie sur cette base en utilisant Cluster API et Fleet, ce qui peut entraîner une confusion quant à la manière dont ces ressources Cluster interagissent et ce que les utilisateurs doivent modifier.

Ce document explique le but, le comportement et les relations entre les ressources de cluster suivantes :

  • clusters.cluster.x-k8s.io (Cluster CAPI)

  • clusters.fleet.cattle.io (Cluster Fleet)

  • clusters.provisioning.cattle.io (Cluster de provisionnement)

  • clusters.management.cattle.io (Cluster de gestion)

Résumé des ressources

Groupe API Ressource de grappe : Rôle

cluster.x-k8s.io

Cluster CAPI

Définit le cycle de vie et la topologie du cluster. Agit comme la source de vérité dans Turtles.

fleet.cattle.io

Cluster Fleet

Utilisé pour le ciblage de bundles GitOps et la synchronisation des applications via Fleet.

provisioning.cattle.io

Cluster de provisionnement

L’ancienne abstraction de clusters à usage général de Rancher. Encapsule à la fois la configuration indépendante de l’infrastructure et spécifique au fournisseur, et est nécessaire pour générer les tokens d’enregistrement de cluster et les manifestes. Dans SUSE® Rancher Prime Cluster API, cette ressource a été utilisée pour envelopper les clusters CAPI importés, mais elle est en cours de suppression.

management.cattle.io

Cluster de gestion

Représentation actuelle des clusters de Rancher. Les clusters management.cattle.io/v3 sont désormais la ressource par défaut créée et gérée par Turtles. Cela ne doit pas être confondu avec les clusters gérés par CAPI, où « géré » fait référence à la gestion du cycle de vie de Cluster API, et non au groupe d’API management.cattle.io de Rancher.

Relations

Cluster CAPI → Cluster Fleet

Lorsque le Cluster API Add-on Provider for Fleet (CAAPF) est activé, il propage les étiquettes et les annotations du Cluster CAPI Cluster vers le Cluster Fleet correspondant Cluster. Cela permet de cibler les bundles GitOps via des sélecteurs d’étiquettes. CAAPF crée la ressource Cluster Fleet correspondante Cluster après que le Cluster CAPI Cluster a atteint la condition ControlPlaneInitialized.

Cluster CAPI → Cluster de provisionnement (hérité)

Un provisioning.cattle.io.Cluster peut être créé pour envelopper le Cluster CAPI et exposer des champs spécifiques à Rancher (par exemple, nom d’affichage, configuration RKE). Cependant, dans la plupart des workflows SUSE® Rancher Prime Cluster API, il est en train d’être supprimé et l’utilisateur n’est pas tenu d’interagir avec cette ressource.

Cluster de gestion → Cluster de provisionnement

Pour les clusters hérités, un provisioning.cattle.io/v1.Cluster peut être généré à partir d’un management.cattle.io/v3.Cluster. Cet objet est utilisé par l’interface utilisateur et les API de Rancher et n’est pas destiné à être modifié directement par les utilisateurs. De nouveaux clusters gérés uniquement via Turtles ne créent pas automatiquement un cluster provisioning.cattle.io.

Comportement de Propagation

De → À Propagation Notes

CAPI → Fleet

Oui

Propagé par CAAPF

CAPI → Provisionnement

Non

Non créé automatiquement ; uniquement généré via Turtles pour les clusters hérités

CAPI → Gestion

Non

Uniquement via le Cluster de Provisionnement pour les clusters hérités

Provisionnement → Fleet

Non

Non pris en charge

Fleet → CAPI

Non

Non pris en charge

Gestion → Provisionnement

Conditional

Uniquement pour les clusters hérités ; les nouveaux clusters gérés par Turtles ne génèrent pas de clusters de provisionnement

Que doivent modifier les utilisateurs ?

Recommandé : cluster.x-k8s.io.Cluster

Le Cluster CAPI est la ressource autoritaire pour la définition de cluster dans SUSE® Rancher Prime Cluster API. Les étiquettes doivent être placées sur l’objet du cluster CAPI. Elles se propageront automatiquement au Cluster Fleet, permettant aux sélecteurs de bundles basés sur des étiquettes de fonctionner comme prévu.

Conditionnel : provisioning.cattle.io.Cluster

Uniquement requis lors de l’utilisation des fonctionnalités de provisionnement natives de Rancher (par exemple, spec.rkeConfig, flux pilotés par l’interface utilisateur). Évitez de modifier sauf si cela est explicitement requis.

Évitez : fleet.cattle.io.Cluster

Les clusters Fleet sont gérés automatiquement. Les modifications sont déconseillées sauf si vous travaillez sur les internes de Fleet.

Évitez : management.cattle.io.Cluster

Ces ressources sont internes et entièrement gérées par Rancher. Ne les modifiez pas.

  • Le Cluster CAPI est la source de vérité.

  • Clusters Fleet sont générés automatiquement à partir des Clusters CAPI via CAAPF.

  • Provisionnement et Clusters de gestion ne sont pas requis sauf si le provisionnement Rancher est impliqué.

Utilisez les étiquettes du Cluster CAPI pour piloter le déploiement des bundles Fleet. Le contrôleur CAAPF garantit que ces étiquettes sont synchronisées avec l’objet Cluster Fleet.

Références