Visão geral do cluster de hub do Gerenciador de Frota

Aplica-se a: ✔️ Fleet Manager com cluster de hub

Quando habilitado, o cluster de hub do Gerenciador de Frota funciona como ponto de gerenciamento central para a propagação de recursos do Kubernetes entre clusters membros usando colocação de recursos.

O que são clusters de hub do Fleet Manager?

No Gerenciador de Frotas do Kubernetes do Azure, os clusters de hub desempenham uma função crucial no gerenciamento de vários clusters de membros, mas são opcionais.

O cluster central facilita o posicionamento de recursos e os Namespaces Gerenciados da Frota por meio de uma versão gerenciada do KubeFleet.

Nessa configuração, uma frota consiste nos seguintes componentes:

Um diagrama do recurso de frota quando configurado com um cluster de hub, incluindo o agente de cluster do hub e o agente de cluster membro.

  • fleet-hub-agent: um controlador kubernetes que cria e reconcilia todos os CRs (recursos personalizados) relacionados à frota no cluster do hub.
  • fleet-member-agent: um controlador kubernetes que cria e reconcilia todas as CRs relacionadas à frota nos clusters membros. Esse controlador efetua o pull dos CRs mais recentes do cluster de hub e reconcilia continuamente os clusters membros para corresponder ao estado desejado.

Configuração do cluster de hub

Um cluster de hub do Gerenciador de Frota é um cluster do Serviço de Kubernetes do Azure (AKS) totalmente gerenciado que possui as seguintes propriedades:

  • Nome e localização do cluster: o cluster de hub é sempre nomeado hub e é criado na mesma região Azure que o Fleet Manager.
  • Azure Grupo de Recursos para cluster de hub: o recurso aks do cluster de hub é criado em um grupo de recursos gerenciado com o formato FL_{fleet_manager_resource_group}_{fleet_manager_name}_{azure_region}de nomenclatura.
  • Azure Grupo de Recursos para recursos de cluster de hub: como qualquer cluster do AKS, o cluster de hub tem recursos Azure, como um conjunto de dimensionamento de máquinas virtuais do pool de nós do agente e uma rede virtual criada em um grupo de recursos gerenciado com o formato MC_FL_{fleet_manager_resource_group}_{fleet_manager_name}_{azure_region}de nomenclatura.
  • Nó de cluster do hub: O cluster do hub tem um pool de nós com um único nó executando Azure Linux. O nó não executa pods e não afeta o desempenho do cluster de hub. Ao criar um cluster de hub na CLI do Azure, você pode escolher o tipo de SKU da máquina virtual (VM) do nó usando o parâmetro --vm-size.
  • Configuração de rede: os clusters de hub público têm um servidor de API público, com um endereço IP público associado. Quando configurado para acesso privado, o servidor de API só é acessível por meio de uma rede virtual do Azure.

Restrições do cluster de hub

O cluster de hub tem as seguintes restrições que garantem seu funcionamento conforme necessário para a propagação e o gerenciamento de recursos:

  • Invocação de Comando Desabilitada: O uso da invocação de comando por meio do CLI do Azure (az aks command invoke) está desabilitado para clusters de hub.
  • Autenticação Local Desabilitada: O acesso por meio do administrador kubeconfig está desabilitado, garantindo que a autenticação seja tratada exclusivamente por meio de Microsoft Entra ID, aprimorando a segurança centralizando o controle de acesso. Use az fleet get-credentials para obter as kubeconfig do cluster de hub.
  • Atribuições de Negação: As alterações na configuração do Azure do cluster de hub e dos recursos associados são bloqueadas por meio de Azure Deny Assignments. As seguintes Atribuições de Negação são usadas:
    • FLRG-DenyAssignments-{guid}: aplicado no grupo de recursos do cluster de hub, impedindo que os usuários modifiquem o cluster do hub.
    • kubernetes.azure.com/{guid}(opcional): essa atribuição de negação impede que os usuários modifiquem os recursos do AKS do cluster de hub (Conjuntos de Dimensionamento de Máquinas Virtuais, redes), conforme descrito no bloqueio do grupo de recursos do nó do AKS.
  • Recursos aplicados não instanciados: O cluster de hub não agenda recursos aplicados do Kubernetes nos nós do cluster de hub. Alguns recursos do Kubernetes devem ser aplicados usando um objeto envelope para evitar efeitos colaterais no cluster de hub. Para obter mais informações sobre objetos envelope, confira a documentação de Objetos Envelope.

Restrições de acesso a recursos protegidos

Importante

A partir de 31 de janeiro de 2027, os clusters de hub do Fleet Manager negam acesso a recursos gerenciados pelo serviço protegidos e interfaces privilegiadas. Essas restrições se aplicam além do controle de acesso baseado em função do Azure (Azure RBAC). Uma atribuição de função Azure que permitiu anteriormente uma solicitação não substitui essas restrições.

As seguintes solicitações de API do Kubernetes são recusadas:

  • Todas as solicitações de personificação de identidade.
  • Todas as operações diferentes de get, list e watch em namespaces com nomes que começam com fleet- ou kube-.
  • get, liste watch solicitações para pods, segredos, contas de serviço, funções e associações de função em namespaces com nomes que começam com fleet- ou kube-.
  • Solicitações entre namespaces list e watch para pods, segredos, contas de serviço, funções e associações de função.
  • Escreva solicitações para ClusterRoles e ClusterRoleBindings.
  • Ler e gravar solicitações no nodes/proxy sub-recurso.
  • Escreva solicitações para validar políticas de admissão, validar associações de política de admissão e validar configurações de webhook com nomes que começam com fleet-builtin-.
  • Solicitações de exclusão de coleções para validar políticas de admissão, validar associações de política de admissão e validar configurações de webhook.

Outras operações com suporte em namespaces gerenciados pelo cliente permanecem disponíveis.

Identificar os recursos e a automação do Fleet Manager afetados

Um recurso do Fleet Manager será potencialmente afetado se ele tiver um cluster de hub habilitado. Use Azure Resource Graph Explorer para localizar estes recursos:

Resources
| where type =~ "microsoft.containerservice/fleets"
| where isnotnull(properties.hubProfile)
| project id, name, subscriptionId, resourceGroup, location

Ter um cluster de hub não significa necessariamente que você precisa tomar medidas. Você será afetado somente se seus usuários, scripts, controladores ou pipelines de CI/CD enviarem uma das solicitações restritas para o cluster do hub.

Examine a automação que acessa o cluster do hub para:

  • Opções ou cabeçalhos de personificação, incluindo --as e --as-group.
  • Solicitações para nodes/proxy.
  • Acesso a namespaces com nomes que começam com fleet- ou kube-.
  • Solicitações de listar e observar, em todo o cluster ou --all-namespaces, para recursos protegidos.
  • Alterações em funções de cluster ou associações de função de cluster.
  • Alterações nos recursos de validação com nomes que começam com fleet-builtin-.
  • Exclusão da coleção de recursos de validação.

Atualização da automação afetada

Antes de 31 de janeiro de 2027:

  • Mova recursos de propriedade do cliente e automação de namespaces com nomes que começam com fleet- ou kube-.
  • Lista de escopo e solicitações de observação para pods, segredos, contas de serviço, funções e associações de função para namespaces gerenciados pelo cliente.
  • Para posicionamento de recursos, encapsular funções de cluster e associações de função de cluster em um ClusterResourceEnvelope. Para obter mais informações, consulte Usar objetos envelope para colocar recursos com segurança.
  • Para acesso programático ao cluster do hub, use uma identidade dedicada do Microsoft Entra, atribua a ela a função RBAC do Fleet Manager menos privilegiada necessária e não use a personificação de identidade.
  • Pare de usar o nodes/proxy sub-recurso.
  • Não modifique os recursos de validação com nomes que começam com fleet-builtin-.
  • Substitua a exclusão da coleção de recursos de validação por solicitações com escopo para recursos gerenciados pelo cliente.
  • Teste a automação atualizada antes da data de vigência.

Se você não atualizar a automação afetada antes de 31 de janeiro de 2027, suas solicitações restritas receberão respostas de autorização negada. Scripts, controladores, implantações ou fluxos de trabalho operacionais que dependem dessas solicitações podem falhar ou tentar novamente repetidamente. Se você não usar nenhuma operação restrita, nenhuma ação será necessária.

Requisitos dos clientes

Para que o Fleet Manager crie e mantenha os clusters de hub up-to-date com os patches mais recentes, verifique se:

  • A política do Azure não bloqueia a criação do cluster. O cluster de hub é um cluster do AKS gerenciado. Se você não puder criar clusters do AKS, não poderá criar um cluster do Hub do Fleet Manager.

  • A assinatura tem cota suficiente. É necessária uma instância de VM extra do nó do cluster de hub durante o processo de atualização do cluster. Para obter mais informações sobre o aumento da cota, consulte a documentação sobre a cota.

  • O cluster de hub tem acesso à Internet. A conectividade de saída é necessária para instalar atualizações. Hubs privados em redes com roteamento definido pelo usuário (UDR) ou regras de firewall podem bloquear a conectividade de saída. Para obter mais informações sobre conectividade de saída, consulte a documentação sobre a rede de saída do AKS.

  • O servidor de API pode alcançar os nós do hub. Se as regras NSG em um cluster de hub privado com integração de VNet do servidor de API restringirem o tráfego entre sub-redes, permita o tráfego de entrada da sub-rede do servidor de API para a sub-rede de cluster na porta TCP 10250. Sem essa regra, as operações que usam a API kubelet, como recuperar logs ou executar exec, falharão. Para todas as regras necessárias, consulte as regras de segurança NSG para integração de VNet do servidor de API.

  • Não é necessário gerenciar atualizações para o cluster de hub do Gerenciador de Frota. A Microsoft atualiza automaticamente o cluster de hub para a versão mais recente do Kubernetes ou da imagem de nó à medida que ficam disponíveis no AKS. As liberações de atualização podem ser acompanhadas no Rastreador de Liberações do AKS.