Verificando se uma atualização de versão está disponível com a CLI do IBM Cloud

1. Efetue login no IBM Cloud. Inclua a opção --sso se tiver uma conta federada.

   ibmcloud login [--sso]
   

2. Liste os clusters do Satellite em sua conta.

   ibmcloud ks cluster ls --provider satellite
   

3. Liste os nós do trabalhador no cluster para o qual você deseja atualizar a versão. Na saída, verifique se há um asterisco * com uma mensagem que indica que uma atualização de versão está disponível.

   ibmcloud ks worker ls -c CLUSTER_NAME_OR_ID
   

   Saída de exemplo

   ID                Primary IP       Flavor   State    Status   Zone     Version   
   sat-worker-<ID>   <IP_address>     upi      normal   Ready    zone-1   4.5.35_1534_openshift*   
   * To update to 4.5.37_1537_openshift version, run 'ibmcloud ks worker replace'. Review and make any required version changes before you update: 'https://ibm.biz/upworker'
   

Verificando se uma atualização de versão está disponível no console do IBM Cloud

1. Faça login no Satellite console.
2. Clique no local com os hosts que deseja atualizar.
3. Clique na guia Hosts.
4. Na lista de hosts, clique no link para o Cluster para o host que você deseja atualizar. Uma nova guia se abre para os detalhes do cluster do Red Hat OpenShift on IBM Cloud.
5. Clique na guia Nós do trabalhador.
6. Na coluna “Versão ”, procure um ícone de informação que, ao clicar nele, exiba a mensagem “ Update available ”. Se nenhuma atualização estiver disponível, nenhum ícone estará presente.
7. Determine se a atualização da versão é uma atualização principal, menor ou de correção.

Aplicar atualizações de versão no nó do trabalhador hospeda um de cada vez

1. Opcional: Anexar e atribuir hospedeiros extras no cluster de serviços para manipular a capacidade de cálculo enquanto seus hosts existentes estão se atualizando.

2. Identificar os hosts de nós do trabalhador. Os hosts do nó do trabalhador não possuem infrastructure listados na coluna Cluster da saída, mas em vez disso têm o nome do cluster.

3. Atualize os nós do trabalhador individualmente executando o comando ibmcloud ks worker update.

   ibmcloud ks worker update -c CLUSTER_NAME_OR_ID --worker WORKER_ID
   

4. Confirme se a atualização está concluída, revisando a versão do Kubernetes de seus nós do trabalhador.

   kubectl get nodes
   

   Se a atualização falhou, você deve aplicar atualizações de versão por meio da substituição de hosts.

Aplique as atualizações de versão aos hosts do nó do trabalhador com um ConfigMap

É possível apresentar as atualizações para todos os hosts do nó do trabalhador com um ConfigMap Especifique quais nós atualizam usando etiquetas. Você também pode especificar

1. Opcional: Anexar e atribuir hospedeiros extras no cluster de serviços para manipular a capacidade de cálculo enquanto seus hosts existentes estão se atualizando.

2. Identificar os hosts de nós do trabalhador. Seus hosts do nó do trabalhador não são listados como Infrastructure.

3. Visualizar os rótulos de um nó do trabalhador. É possível localizar os rótulos de nó do trabalhador na seção Rótulos de sua saída da CLI. Cada rótulo consiste em um NodeSelectorKey e um NodeSelectorValue. Você pode usar os rótulos para especificar quais nós do trabalhador atualizam.

   kubectl get nodes -o yaml
   

   Saída de exemplo

   labels:
     arch: amd64
     beta.kubernetes.io/arch: amd64
     beta.kubernetes.io/instance-type: upi
     beta.kubernetes.io/os: linux
     failure-domain.beta.kubernetes.io/region: us-east
     failure-domain.beta.kubernetes.io/zone: us-east-2
     ibm-cloud.kubernetes.io/iaas-provider: upi
     ibm-cloud.kubernetes.io/internal-ip: 10.241.0.4
     ibm-cloud.kubernetes.io/machine-type: upi
     ibm-cloud.kubernetes.io/os: REDHAT_8_64
     ibm-cloud.kubernetes.io/region: us-east
     ibm-cloud.kubernetes.io/worker-id: sat-satellitei-5bd83963cdfedc7668c9040879c88113a134c4e7
     ibm-cloud.kubernetes.io/worker-pool-id: cbtljodw089nltg8k210-9a3f763
     ibm-cloud.kubernetes.io/worker-pool-name: default
     ibm-cloud.kubernetes.io/worker-version: 4.7.59_1583_openshift
     ibm-cloud.kubernetes.io/zone: us-east-2
     kubernetes.io/arch: amd64
     kubernetes.io/hostname: satellite-ibm-host-3
     kubernetes.io/os: linux
     node-role.kubernetes.io/master: ""
     node-role.kubernetes.io/worker: ""
     node.kubernetes.io/instance-type: upi
     node.openshift.io/os_id: rhel
     privateVLAN: "1"
     topology.kubernetes.io/region: us-east
     topology.kubernetes.io/zone: us-east-2
   

4. Crie um ConfigMap e defina as regras de indisponibilidade para seus nós de trabalho. O exemplo a seguir mostra dois cheques: o “ defaultcheck.json ” e um modelo de cheque. É possível usar essa verificação de exemplo para definir regras para todos os nós do trabalhador que não correspondem a nenhuma das verificações definidas no ConfigMap (defaultcheck.json). Use o modelo de verificação para criar a sua própria verificação Para cada verificação, para identificar um nó do trabalhador, deve-se escolher um dos rótulos de nó do trabalhador que você recuperou na etapa anterior.

   Para cada verificação, é possível configurar somente um valor para NodeSelectorKey e NodeSelectorValue. Defina até 10 verificações em um “ ConfigMap ”. Se você incluir mais verificações, elas serão ignoradas.

   Exemplo

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: ibm-cluster-update-configuration
     namespace: kube-system
   data:
     drain_timeout_seconds: "120"
     defaultcheck.json: |
       {
         "MaxUnavailablePercentage": 20
       }
     <check_name>: |
       {
         "MaxUnavailablePercentage": <value_in_percentage>,
         "NodeSelectorKey": "<node_selector_key>",
         "NodeSelectorValue": "<node_selector_value>"
       }
   

   drain_timeout_seconds

   Opcional: o tempo limite em segundos para esperar a conclusão do dreno. A drenagem de um nó do trabalhador remove com segurança todos os pods existentes do nó do trabalhador e reagenda os pods em outros nós do trabalhador no cluster. Os valores aceitos são números inteiros no intervalo de 1 a 180. O valor padrão é 30.

   defaultcheck.json

   Quando você atualiza nós do trabalhador em hosts Satellite, apenas 20% dos nós do trabalhador no cluster podem ficar indisponíveis por vez.

   MaxUnavailablePercentage

   O número máximo de nós que podem ficar indisponíveis para uma chave e um valor de rótulo especificados, que são especificados como uma porcentagem. Um nó do trabalhador está indisponível durante o processo de implementação, recarregamento ou provisionamento. Os nós do trabalhador enfileirados são bloqueados de atualização se excedem qualquer porcentagem máxima indisponível definida.

   NodeSelectorKey

   A chave de rótulo do nó do trabalhador para o qual você deseja configurar uma regra. É possível configurar regras para os rótulos padrão que são fornecidos pela IBM, bem como nos rótulos de nó do trabalhador que você criou.

   NodeSelectorValue

   O valor do rótulo que o nó do trabalhador deve ter para ser considerado para a regra que você define.

5. Crie o configmap em seu cluster.

   kubectl apply -f <filepath/configmap.yaml>
   

6. Verifique se o arquivo ConfigMap foi criado.

   kubectl get configmap --namespace kube-system
   

7. Atualize os nós do trabalhador ao listá-los por ID.

   ibmcloud ks worker update --cluster <cluster_name_or_ID> --worker <worker_node1_ID> --worker <worker_node2_ID>
   

8. Opcional: Verifique os eventos acionados pelo método ConfigMap e quaisquer erros de validação que ocorram. Os eventos podem ser revisados na seção Eventos de sua saída da CLI.

   kubectl describe -n kube-system cm ibm-cluster-update-configuration
   

9. Confirme se a atualização está concluída, revisando a versão do Kubernetes de seus nós do trabalhador.

   kubectl get nodes
   

   Se a atualização falhou, você deve aplicar atualizações de versão por meio da substituição de hosts.

10. Verifique se você não tem nós de trabalhador duplicados. Clusters mais antigos podem listar nós de trabalho duplicados com um NotReady status após uma atualização. Para remover duplicatas, consulte Resolução de problemas.