Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Relaciones de recursos del clúster en SUSE® Rancher Prime Cluster API

Descripción general

Rancher integra varios componentes que definen sus propios recursos personalizados de Cluster. SUSE® Rancher Prime Cluster API se basa en esta infraestructura utilizando Cluster API y Fleet, lo que puede llevar a confusiones sobre cómo interactúan estos recursos Cluster y qué deben editar los usuarios.

Este documento explica el propósito, comportamiento y relaciones entre los siguientes recursos del clúster:

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

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

  • clusters.provisioning.cattle.io (Provisioning Cluster)

  • clusters.management.cattle.io (Management Cluster)

Resumen de recursos

Grupo API Recurso del clúster Función

cluster.x-k8s.io

CAPI Cluster

Define el ciclo de vida y la topología del clúster. Actúa como la fuente de verdad en Turtles.

fleet.cattle.io

Clúster de Fleet

Se utiliza para la sincronización de aplicaciones y la orientación de paquetes GitOps a través de Fleet.

provisioning.cattle.io

Provisioning Cluster

La abstracción de clúster de propósito general anterior de Rancher. Encapsula tanto la configuración independiente de la infraestructura como la específica del proveedor, y es necesaria para generar tokens de registro de clúster y manifiestos. En SUSE® Rancher Prime Cluster API, este recurso se ha utilizado para envolver clústeres CAPI importados, pero se está eliminando gradualmente.

management.cattle.io

Clúster de gestión

La representación actual del clúster de Rancher. Los clústeres management.cattle.io/v3 son ahora el recurso predeterminado creado y gestionado por Turtles. Esto no debe confundirse con los clústeres gestionados por CAPI, donde "gestionado" se refiere a la gestión del ciclo de vida de Cluster API, no al grupo API management.cattle.io de Rancher.

Relaciones

CAPI Cluster → Fleet Cluster

Cuando se habilita Cluster API Add-on Provider for Fleet (CAAPF), propaga etiquetas y anotaciones desde el CAPI Cluster al correspondiente Fleet Cluster. Esto permite dirigir paquetes de GitOps a través de selectores de etiquetas. CAAPF crea el recurso correspondiente de Fleet Cluster después de que el CAPI Cluster alcanza la condición ControlPlaneInitialized.

CAPI Cluster → Provisioning Cluster (Legado)

Se puede crear un provisioning.cattle.io.Cluster para envolver el Clúster CAPI y exponer campos específicos de Rancher (por ejemplo, nombre para mostrar, configuración de RKE). Sin embargo, en la mayoría de los flujos de trabajo de SUSE® Rancher Prime Cluster API, se está eliminando y no se requiere que el usuario interactúe con este recurso.

Management Cluster → Provisioning Cluster

Para clústeres heredados, se puede generar un provisioning.cattle.io/v1.Cluster a partir de un management.cattle.io/v3.Cluster. Este objeto es utilizado por la interfaz de usuario y las API de Rancher y no está destinado a ser modificado directamente por los usuarios. Los nuevos clústeres gestionados únicamente a través de Turtles no crean automáticamente un clúster provisioning.cattle.io.

Comportamiento de Propagación

De → A Propagación Notas

CAPI → Fleet

Sí

Propagado por CAAPF

CAPI → Provisioning

No

No se crea automáticamente; solo se genera a través de Turtles para clústeres heredados

CAPI → Management

No

Solo a través del Provisioning Cluster para clústeres heredados.

Provisioning → Fleet

No

No compatible

Fleet → CAPI

No

No compatible

Management → Provisioning

Condicional

Solo para clústeres heredados; los nuevos clústeres gestionados por Turtles no generan Provisioning Clusters.

¿Qué deben editar los usuarios?

Recomendado: cluster.x-k8s.io.Cluster

El clúster CAPI es el recurso autoritativo para la definición de clúster en SUSE® Rancher Prime Cluster API. Las etiquetas deben colocarse en el objeto del clúster CAPI. Se propagarán automáticamente al clúster Fleet, permitiendo que los selectores de paquetes basados en etiquetas funcionen como se espera.

Condicional: provisioning.cattle.io.Cluster

Solo es necesario al utilizar características de aprovisionamiento nativas de Rancher (por ejemplo, spec.rkeConfig, flujos impulsados por la interfaz de usuario). Evitar editar a menos que sea explícitamente necesario.

Evitar: fleet.cattle.io.Cluster

Los clústeres Fleet se gestionan automáticamente. Se desaconsejan las ediciones a menos que se esté trabajando en los internos de Fleet.

Evitar: management.cattle.io.Cluster

Estos recursos son internos y están completamente gestionados por Rancher. No se deben modificar.

  • El CAPI Cluster es la fuente de verdad.

  • Fleet Clusters se generan automáticamente a partir de clústeres CAPI a través de CAAPF.

  • Los clústeres Provisioning y Management Clusters no son necesarios a menos que se utilicen las características de aprovisionamiento nativas de Rancher.

Utiliza las etiquetas del clúster CAPI para impulsar el despliegue del paquete de Fleet. El controlador CAAPF asegura que esas etiquetas estén sincronizadas con el objeto del clúster de Fleet.

Referencias