Atualizar um cluster do Azure Red Hat OpenShift

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. A atualização dos clusters do Azure Red Hat OpenShift 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 OpenShift usando o console da Web OpenShift, CLI ou o operador de atualização gerenciado (MUO). Para obter mais detalhes sobre as atualizações do OpenShift, consulte Noções básicas sobre as atualizações do OpenShift

Pré-requisitos

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

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

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

1. No menu esquerdo do console da Web OpenShift, verifique se você está na perspetiva Administrador , que é o padrão quando você assina como kubeadmin.

2. Selecione a guia Administração .

3. Selecione Configurações do 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. Uma vez que o canal desejado é escolhido, um gráfico mostrando as versões disponíveis e canais é exibido. Se o Status de Atualização do cluster mostrar Atualizações Disponíveis, você poderá atualizá-lo.

Atualize seu cluster com o console da Web OpenShift

No console da Web 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 selecione 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 nós.

Agende atualizações individuais usando o operador de upgrade gerenciado

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

O operador de upgrade gerenciado gerencia atualizações de cluster automatizadas. O operador managed-upgrade-inicia a atualização do cluster, mas não executa nenhuma atividade do processo de atualização do cluster em si. A OpenShift Container Platform (OCP) é responsável pela atualização dos clusters. O objetivo do operador de upgrade gerenciado é satisfazer as 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 é o momento em que a atualização ocorre.
• channel é o canal do qual o arquivo de configuração extrai, de acordo com a política de ciclo de vida. O canal utilizado 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

Atualize seu cluster usando a CLI

Consulte o seguinte para Atualizar um cluster usando a CLI.

Atualizações do Termo 1 do Extended Update Support Add-on (EUS)

Ao atualizar seu cluster de uma versão do EUS para outra versão do EUS (por exemplo, 4.16 a 4.18), você precisará atualizar para a versão provisória e, em seguida, para a versão EUS de destino. Por exemplo, para atualizar de 4.16 para 4.18, você deve atualizar para 4.17 e, em seguida, para 4.18. Não há suporte para atualizações somente do plano 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óximos passos

• Você pode encontrar informações sobre os avisos e atualizações disponíveis do OpenShift Container Platform na seção errata do Portal do Cliente Red Hat.