Atualizar um cluster do Red Hat OpenShift no Azure

Como parte do ciclo de vida do cluster Red Hat OpenShift do Microsoft Azure, você precisa executar atualizações periódicas para a versão mais recente da plataforma OpenShift. Atualizar os clusters do Red Hat OpenShift no Azure permite que você atualize para os recursos e funcionalidades mais recentes e aplique as versões de segurança mais recentes.

Este artigo mostra como atualizar todos os componentes em um cluster do OpenShift usando o console Web do OpenShift, a CLI ou o MUO (operador de atualização gerenciada). Para obter mais informações sobre atualizações do OpenShift, consulte Noções básicas sobre atualizações do OpenShift.

Importante

Não há suporte para a execução de uma atualização somente do Plano de Controle para o Red Hat OpenShift do Azure e pode resultar em instabilidade de cluster.

Note

Para obter mais informações sobre como atualizar da 4.20 para a 4.21, consulte Atualização da 4.20 para a 4.21.

Pré-requisitos

Verificar se há atualizações de cluster disponíveis usando o console Web

  1. No menu à esquerda do console Web do OpenShift, verifique se você está na perspectiva administrador , que é o padrão quando você assina como kubeadmin.

  2. Selecione a guia Administração.

  3. Selecione Configurações de Cluster e abra a guia Detalhes . A versão, o status da atualização e o canal são exibidos. O canal não está configurado por padrão.

  4. Selecione o link canal e, no prompt, insira o canal de atualização desejado, por exemplo stable-4.19. Após selecionar o canal desejado, é exibido um gráfico mostrando as versões e os canais disponíveis. Se o Status da atualização do cluster refletir Atualizações disponíveis, você poderá atualizar o cluster.

Atualizar seu cluster com o console Web do OpenShift

No console Web do OpenShift na etapa anterior, defina o Canal para a versão para a qual você deseja atualizar, como stable-4.19.

Selecione uma versão para a qual atualizar e escolha Atualizar. Você verá a alteração do status da atualização para: Update to <product-version> in progress. Você pode revisar o progresso da atualização do cluster observando as barras de progresso dos operadores e dos nós.

Agendar atualizações individuais usando o operador de atualização gerenciado

Use o MUO (operador de atualização gerenciada) para atualizar o cluster do Red Hat OpenShift no Azure.

O operador de atualização gerenciada gerencia atualizações de cluster automatizadas. O operador de atualização gerenciada inicia a atualização do cluster, mas não executa nenhuma atividade do próprio processo de atualização do cluster. A Plataforma de Contêiner do OpenShift (OCP) é responsável por atualizar os clusters. A meta do operador de atualização gerenciada é atender às condições operacionais que um cluster gerenciado deve manter, antes e depois de iniciar a atualização do cluster.

  1. Prepare o arquivo de configuração, conforme mostrado no exemplo a seguir para atualizar para o OpenShift 4.19.
apiVersion: upgrade.managed.openshift.io/v1alpha1
kind: UpgradeConfig
metadata:
  name: managed-upgrade-config
  namespace: openshift-managed-upgrade-operator
spec:
  type: "ARO"
  upgradeAt: "2025-09-08T03:20:00Z"
  PDBForceDrainTimeout: 60
  desired:
    channel: "stable-4.19"
    version: "4.19.15"
  • upgradeAT é a hora em que a atualização ocorre.
  • channel é o canal do qual o arquivo de configuração é extraído, de acordo com a política de ciclo de vida. O canal usado deve ser stable-<version> ou eus-<version>.
  • version é a versão para a qual você deseja atualizar, como 4.19.15.
  1. Aplique o arquivo de configuração. Substitua <file_name> pelo nome do arquivo.
oc create -f <file_name>.yaml

Atualizar seu cluster usando a CLI

Para obter mais informações, consulte Atualizar um cluster usando a CLI.

Atualizações do Termo 1 do Complemento de Suporte de Atualização Estendida (EUS)

Ao atualizar seu cluster de uma versão do EUS para outra versão da UES (por exemplo, 4.16 para 4.18), você precisa atualizar para a versão provisória e, em seguida, para a versão de destino da UES. Por exemplo, para atualizar da 4.16 para a 4.18, você deve atualizar para 4.17 e, em seguida, para 4.18. Não há suporte para atualizações somente do Painel de Controle. Você também deve selecionar o canal de atualização relevante para sua versão de destino, por exemplo eus-4.18.

Atualizando da 4.20 para a 4.21

A política de imagem do openshift cluster atingiu a disponibilidade geral na versão 4.21. Como resultado, as assinaturas do Sigstore para as quay.io/openshift-release-dev/ocp-release imagens agora são necessárias para verificação de versão. Se você tentar atualizar para a versão 4.21, "Este cluster tem espelhos configurados. 4.21 exigirá assinaturas do Sigstore..." a mensagem bloqueia a atualização. Para Red Hat OpenShift no Azure clusters, nenhuma ação adicional é necessária porque o serviço já fornece as imagens de assinatura do Sigstore necessárias.

Para continuar com a atualização, forneça a confirmação do administrador. Execute o seguinte comando antes de prosseguir:

oc -n openshift-config patch configmap admin-acks --patch '{"data":{"ack-4.20-sigstore-in-4.21":"true"}}' --type=merge

Próximas etapas

  • Você pode encontrar informações sobre os avisos e atualizações disponíveis da Plataforma de Contêiner do OpenShift na seção errata do Portal do Cliente do Red Hat.
  • Last updated on