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 detalhes sobre atualizações do OpenShift, consulte Noções básicas sobre atualizações do OpenShift

Pré-requisitos

• Este artigo pressupõe que você tenha acesso a um cluster do Red Hat OpenShift no Azure existente como um usuário com privilégios admin.

• Verifique se as credenciais da entidade de serviço usadas para o cluster são válidas/atualizadas antes de iniciar a atualização. Para obter mais informações, consulte Rotacionar os principais de serviço para o cluster do Red Hat OpenShift no Azure.

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. Depois que o canal desejado é escolhido, um grafo mostrando versões e canais disponíveis é exibido. 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.

2. 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

Consulte o seguinte para atualizar um cluster usando a CLI.

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

Ao atualizar o cluster de uma versão do EUS para outra versão da UES (por exemplo, 4.16 para 4.18), você precisará 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.

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.