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.

Fornecedor de Complemento da API de Cluster Fleet

Visão Geral

O Fornecedor de Complemento da API de Cluster para Fleet (CAAPF) é um fornecedor da API de Cluster (CAPI) que fornece integração com Fleet para permitir a fácil implantação de aplicativos em um cluster provisionado pelo CAPI.

Para mais informações sobre o fornecedor, consulte o livro CAAPF.

O CAAPF depende da WatchList feature gate do Kubernetes. Esse recurso precisa ser explicitamente habilitado nas versões do Kubernetes 1.33. Consulte a a documentação upstream do Kubernetes para mais informações.

Funcionalidade

  • O fornecedor registrará um cluster CAPI recém-provisionado com Fleet criando uma instância Fleet Cluster com o mesmo name e namespace. Os aplicativos podem ser implantados automaticamente no cluster criado usando GitOps.

  • O fornecedor criará automaticamente um Fleet ClusterGroup para cada CAPI ClusterClass no namespace ClusterClass. Isso permite que você implante os mesmos aplicativos em todos os clusters criados a partir do mesmo ClusterClass.

  • O fornecedor criará automaticamente um Fleet ClusterGroup para cada CAPI ClusterClass referenciado por Cluster localizado em um namespace diferente de ClusterClass. Isso permite que você implante os mesmos aplicativos em todos os clusters que referenciam o mesmo ClusterClass em um namespace específico.

Isso permite que um usuário especifique um recurso Bundle com cargas de trabalho de aplicativo brutas, ou GitRepo para instalar aplicativos a partir do git. Cada um dos recursos pode fornecer targets com qualquer combinação de:

  targets:
  - clusterGroup: <cluster-class-name> # If the cluster is created from cluster-class
  - clusterName: <a specific CAPI cluster name>

Além disso, CAAPF propaga automaticamente os rótulos do cluster CAPI para o recurso de cluster Fleet, para que os usuários possam especificar um alvo que corresponda a um rótulo de cluster comum com:

  targets:
  - clusterSelector: <label selector for the cluster instances, inherited from CAPI clusters>
  - clusterGroupSelector: <label selector for the cluster group instances, labels inherited from ClusterClass>

Modelagem de Helm Chart baseada em CAPI Cluster e ControlPlane

O Fornecedor de Complemento da API de Cluster Fleet automatiza a modelagem de aplicativos para clusters CAPI importados com base no estado do cluster correspondente. Esse recurso garante que o estado de um cluster CAPI e os recursos estejam sempre atualizados no campo spec.templateValues.ClusterValues do recurso de cluster Fleet. Isso permite que os usuários:

  • Referenciar partes específicas do cluster CAPI diretamente ou por meio de padrões de substituição do Helm que referenciam os dados de .ClusterValues.Cluster.

  • Substituir com base no estado do recurso do plano de controle através do campo .ClusterValues.ControlPlane.

  • Substituir com base no estado do recurso do cluster de infraestrutura através do campo .ClusterValues.InfrastructureCluster.

  • Manter um estado consistente dos aplicativos entre diferentes clusters.

  • Utilizar o mesmo modelo para múltiplos clusters correspondentes para simplificar a implantação e a gestão.

Para mais informações sobre o recurso, consulte a documentação de modelagem no livro.

Exemplo - implantando o CNI kindnet

Demonstração: asciicast

Exemplo - implantando o CNI Calico usando GitRepo

Demonstração: asciicast

Para um tutorial e pré-requisitos, consulte a seção tutorial do gitrepo no livro.