Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Relacionamentos de Recursos de Cluster em SUSE® Rancher Prime Cluster API

Visão Geral

O Rancher integra vários componentes que definem seus próprios recursos personalizados Cluster. O SUSE® Rancher Prime Cluster API se baseia nessa fundação utilizando Cluster API e Fleet, o que pode levar a confusão sobre como esses recursos Cluster interagem e o que os usuários devem editar.

Este documento explica o propósito, comportamento e relacionamentos entre os seguintes recursos de cluster:

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

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

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

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

Resumo do Recurso

Grupo da API Recurso de Cluster Função

cluster.x-k8s.io

Cluster CAPI

Define o ciclo de vida e a topologia do cluster. Atua como a fonte da verdade nos Turtles.

fleet.cattle.io

Cluster Fleet

Usado para direcionamento de pacotes GitOps e sincronização de aplicativos via Fleet.

provisioning.cattle.io

Cluster de Provisionamento

A abstração de cluster de propósito geral anterior do Rancher. Encapsula tanto a configuração independente de infraestrutura quanto a específica do provedor, e é necessário para gerar tokens de registro de cluster e manifests. Em SUSE® Rancher Prime Cluster API, este recurso foi usado para envolver clusters CAPI importados, mas está sendo descontinuado.

management.cattle.io

Cluster de gerenciamento

A representação atual de cluster do Rancher. Os clusters management.cattle.io/v3 agora são o recurso padrão criado e gerenciado pelos Turtles. Isso não deve ser confundido com clusters gerenciados pelo CAPI, onde "gerenciado" se refere à gestão do ciclo de vida da API de Cluster, não ao grupo da API management.cattle.io do Rancher.

Relacionamentos

Cluster CAPI → Cluster Fleet

Quando o provedor de complemento da API do Cluster para Fleet (CAAPF) está habilitado, ele propaga rótulos e anotações do CAPI Cluster para o correspondente Fleet Cluster. Isso permite direcionar pacotes GitOps por meio de seletores de rótulos. O CAAPF cria o recurso correspondente do Fleet Cluster após o CAPI Cluster atingir a condição ControlPlaneInitialized.

Cluster CAPI → Cluster de Provisionamento (Legado)

Um provisioning.cattle.io.Cluster pode ser criado para envolver o Cluster CAPI e expor campos específicos do Rancher (por exemplo, nome de exibição, configuração RKE). No entanto, na maioria dos fluxos de trabalho SUSE® Rancher Prime Cluster API, ele está sendo descontinuado e o usuário não precisa interagir com esse recurso.

Cluster de Gerenciamento → Cluster de Provisionamento

Para clusters legados, um provisioning.cattle.io/v1.Cluster pode ser gerado a partir de um management.cattle.io/v3.Cluster. Este objeto é utilizado pela interface do usuário e APIs do Rancher e não é destinado à modificação direta pelos usuários. Novos clusters gerenciados exclusivamente via Turtles não criam automaticamente um cluster provisioning.cattle.io.

Comportamento de Propagação

De → Para Propagação Notes

CAPI → Fleet

Sim

Propagado pelo CAAPF

CAPI → Provisionamento

Não

Não criado automaticamente; gerado apenas via Turtles para clusters legados

CAPI → Gerenciamento

Não

Apenas via Cluster de Provisionamento para clusters legados

Provisionamento → Fleet

Não

Não suportado

Fleet → CAPI

Não

Não suportado

Gerenciamento → Provisionamento

Condicional

Apenas para clusters legados; novos clusters gerenciados pelo Turtles não geram clusters de provisionamento

O que os usuários devem editar?

Recomendado: cluster.x-k8s.io.Cluster

O Cluster CAPI é o recurso autoritativo para definição de cluster em SUSE® Rancher Prime Cluster API. Rótulos devem ser colocados no objeto Cluster CAPI. Eles se propagarão automaticamente para o Fleet Cluster, permitindo que seletores de pacotes baseados em rótulos funcionem como esperado.

Condicional: provisioning.cattle.io.Cluster

Apenas necessário ao usar recursos de provisionamento nativos do Rancher (por exemplo, spec.rkeConfig, fluxos guiados pela interface). Evite editar, a menos que explicitamente necessário.

Evitar: fleet.cattle.io.Cluster

Fleet Clusters são gerenciados automaticamente. Edições são desencorajadas, a menos que esteja trabalhando nos internos do Fleet.

Evitar: management.cattle.io.Cluster

Esses recursos são internos e totalmente gerenciados pelo Rancher. Não os modifique.

  • O CAPI Cluster é a fonte da verdade.

  • Fleet Clusters são gerados automaticamente a partir de CAPI Clusters via CAAPF.

  • Provisionamento e Clusters de Gerenciamento não são necessários a menos que o provisionamento do Rancher esteja envolvido.

Use os rótulos do CAPI Cluster para direcionar a implantação do pacote Fleet. O controlador CAAPF garante que esses rótulos estejam sincronizados com o objeto Fleet Cluster.

Referências