Container Service for Kubernetes:ack-koordinator (FKA ack-slo-manager)

Architecture

ack-koordinator é composto por componentes centrais e componentes no nível do nó.

• Koordinator Manager: componente central implantado como um Deployment. É composto por uma instância primária e uma instância em standby para garantir alta disponibilidade.

  • SLO Controller: gerencia a superalocação de recursos. Ajusta dinamicamente os recursos superalocados no cluster com base no status de execução dos nós durante a colocalização e gerencia políticas de SLO diferenciadas para cada nó.

  • Recommender: fornece o recurso de criação de perfis de recursos. Estima os requisitos de pico de recursos para workloads a fim de simplificar a configuração de especificações de recursos de contêineres.

• Koordinator Descheduler: componente central implantado como um Deployment que fornece o recurso de reagendamento.

• Koordlet: componente no nível do nó implantado como um DaemonSet. Suporta superalocação dinâmica de recursos, agendamento com consciência de carga e agendamento com consciência de QoS em cenários de colocalização.

• Plug-in de agendamento do Koordinator: o módulo Koord-Scheduler não é incluído ao instalar o componente ack-koordinator. Em vez disso, suas capacidades de agendamento são integradas como um plug-in no agendador ACK e instaladas por padrão.

Versioning

A partir da v1.1.1-ack.1, o número de versão do ack-koordinator utiliza o formato x.y.z-ackn.

• x.y.z: corresponde à versão open source do Koordinator, indicando que o ack-koordinator suporta todos os recursos dessa versão.

• ackn: representa aprimoramentos de recursos e otimizações baseados na versão open source.

Conceitos principais

Pré-requisitos

• Tenha um cluster ACK com Kubernetes 1.18 ou posterior. Para mais informações sobre como atualizar um cluster, consulte Manually upgrade a cluster.

• Tenha o Helm v3.0 ou posterior instalado. Para atualizar o Helm, consulte [[Component Upgrade] Announcement on Helm V2 Tiller Upgrade](t1872780.dita#task_2435198) e How do I manually upgrade the version of Helm?.

Instalar e gerenciar o componente

Instale o componente ack-koordinator na página Add-ons. Retorne a essa página sempre que precisar modificar os parâmetros do componente ou atualizá-lo.

Para versões do componente anteriores à v0.7 implantadas pelo Marketplace, consulte Migrate ack-koordinator from Marketplace to add-ons para concluir a migração.

• Instalar o componente: siga os passos abaixo para instalar o componente e verificar a implantação.

• Modificar parâmetros do componente: o sistema reimplanta automaticamente o ack-koordinator com base na nova configuração.

• Atualizar o componente: se você tiver modificado manualmente os módulos implantados do ack-koordinator, como Deployments ou DaemonSets, a atualização sobrescreverá suas configurações personalizadas.

1. Acesse o ACK console. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons .

3. Na página Add-ons, clique na aba Install, localize e selecione o componente ack-koordinator(ack-slo-manager) e clique em Next.

4. Siga as instruções na tela para concluir a configuração do componente e clique em Next.

5. Verifique as informações de configuração e clique em OK.

Desinstalar o componente

Relação entre ack-koordinator e ack-slo-manager

ack-slo-manager é o predecessor do ack-koordinator e incubou o projeto open source Koordinator. À medida que o Koordinator amadureceu, suas tecnologias foram incorporadas de volta ao ack-slo-manager. O ack-koordinator oferece os recursos da versão open source do Koordinator e disponibiliza mais capacidades do que seu predecessor. Para acessar novos recursos e correções de bugs, atualize para a versão mais recente do componente seguindo as instruções em Migrate ack-koordinator from Marketplace to Add-ons.

Migrar o ack-koordinator do Marketplace para Add-ons

Se você implantou o ack-koordinator pelo Marketplace (versões anteriores à v0.7), desinstale-o e reinstale-o. Siga as instruções abaixo para concluir a migração.

Se você modificou o ConfigMap do ack-koordinator do Marketplace, faça um backup antes de atualizar. Caso não tenha modificado o ConfigMap, avance para o passo 2 e atualize o componente diretamente.

1. Faça backup do ConfigMap do ack-koordinator usando kubectl ou o console.

   kubectl

   1. Execute o comando a seguir para salvar a configuração original no arquivo slo-config.yaml. Substitua o namespace (por exemplo, kube-system) e o nome (por exemplo, ack-slo-manager-config) pelos valores reais do seu ConfigMap.

      kubectl get cm -n kube-system ack-slo-manager-config -o yaml > slo-config.yaml

   2. Execute o comando vim slo-config.yaml para editar o arquivo. Altere o namespace do ConfigMap para kube-system, altere o campo name para ack-slo-config e remova todas as annotations e labels do ConfigMap para evitar que sejam sobrescritas durante a atualização.

   3. Execute o comando a seguir para aplicar a configuração modificada ao cluster.

      kubectl apply -f slo-config.yaml 

   Console

   1. Registre os pares de chave-valor do ConfigMap original.

      1. No painel de navegação à esquerda, escolha Configurations > ConfigMaps. No topo da página, selecione o Namespace que você especificou ao instalar o ack-koordinator pelo Marketplace. O namespace padrão é kube-system.

      2. Na caixa de pesquisa Name, insira ack-slo-manager-config, clique no nome do ConfigMap de destino e registre os pares de chave-valor do ConfigMap.

   2. Crie um novo ConfigMap usando os pares de chave-valor do ConfigMap original.

      1. No painel de navegação à esquerda, escolha Configurations > ConfigMaps. No topo da página, selecione All Namespaces.

      2. No canto superior direito da página ConfigMaps, clique em Create. Defina ConfigMap Name como ack-slo-config e selecione o namespace kube-system. Clique em + Add, insira os pares de chave-valor registrados e clique em Create.

2. No painel de navegação à esquerda, escolha Applications > Helm. Localize o componente ack-slo-manager instalado pelo Marketplace e, na coluna Actions, clique em Delete para desinstalá-lo.

   Na página Add-ons, instale a versão mais recente do ack-koordinator. Para mais informações, consulte Install and manage components.

   Importante

   Se você modificou o ConfigMap do componente ack-koordinator do Marketplace, insira o nome do ConfigMap de backup criado no Passo 1 (por exemplo, ack-slo-config) no campo de parâmetro correspondente na caixa de diálogo ack-koordinator Parameters.

Migrar do resource-controller para o ack-koordinator

O componente resource-controller foi descontinuado. O ack-koordinator agora suporta todos os recursos do resource-controller, como topology-aware CPU scheduling e dynamically modifying the resource parameters of a pod. Se o seu cluster utiliza resource-controller, siga estes passos para migrar do resource-controller para o ack-koordinator.

1. Atualize o resource-controller para a versão mais recente.

   1. Acesse o ACK console. No painel de navegação à esquerda, clique em Clusters.

   2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons .

   3. Na página Add-ons, localize o resource-controller e siga as instruções na tela para atualizar o componente.

2. Instale e configure o ack-koordinator.

   1. Na página Add-ons, localize o ack-koordinator e siga as instruções na tela para instalá-lo.

   2. Após a conclusão da instalação, acesse a página Add-ons e clique em Configuration na coluna Actions do add-on ack-koordinator. Configure o parâmetro agentFeatures, que é o interruptor de feature-gate do Koordlet, e demais parâmetros conforme necessário. Em seguida, clique em OK.

      1. Verifique se o cluster utiliza o recurso CPU Limit adjustment descrito em Dynamically modify the resource parameters of a pod. Esse recurso modifica o arquivo cgroups cpu.cfs_quota_us de um contêiner específico criando um CRD ou adicionando uma anotação ao pod. Se você usar esse recurso, avance para o passo ii. Caso contrário, avance para o passo c.

      2. Execute o comando a seguir para obter a configuração atual de feature-gate no arquivo YAML do DaemonSet do ack-koordlet.

         kubectl get daemonset -n kube-system ack-koordlet -o yaml |grep feature-gates
         - --feature-gates=AllAlpha=false,AllBeta=false,...,CPUBurst=true,....

      3. Modifique a configuração de feature-gate do ack-koordlet para desativar o CPU Burst performance optimization policy definindo CPUBurst=false. Use vírgulas (,) para separar os parâmetros. Mantenha as demais configurações sem alteração.

         Desativar a política também desativa o mecanismo CPU Burst para todos os contêineres do cluster, impedindo que dois módulos modifiquem simultaneamente o arquivo cgroups cpu.cfs_quota_us.

         AllAlpha=false,AllBeta=false,...,CPUBurst=false,....

         Para ativar recursos elásticos de CPU para contêineres, utilize a política de otimização de desempenho CPU Burst para ajustar automaticamente a elasticidade de CPU dos pods. Para mais informações, consulte Enable the CPU Burst performance optimization policy.

   3. No painel de navegação à esquerda, escolha Applications > Helm para visualizar o status de implantação do ack-koordinator.

3. Na página Add-ons, localize o resource-controller e siga as instruções na tela para desinstalá-lo.

Notas de versão

Julho de 2024

Janeiro de 2024

Dezembro de 2023

Outubro de 2023

Junho de 2023

Abril de 2023

Março de 2023

Janeiro de 2023