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 mais informações sobre as atualizações do OpenShift, consulte Compreender 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. Depois de selecionar o canal pretendido, é apresentado um gráfico que mostra os lançamentos e canais disponíveis. Se o Estado da atualização do seu cluster mostrar Atualizações disponíveis, pode atualizar o cluster.

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. Pode acompanhar o progresso da atualização do cluster através das barras de progresso dos operadores e dos 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

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

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

Ao atualizar o seu cluster de uma versão EUS para outra versão EUS (ex: 4.16 a 4.18), precisa de atualizar para a versão intermédia e depois para a versão EUS alvo. Por exemplo, para atualizar de 4.16 para 4.18, você deve atualizar para 4.17 e, em seguida, para 4.18. As atualizações apenas do Plano de Controlo não são suportadas. Você também deve selecionar o canal de atualização relevante para sua versão de destino, por exemplo eus-4.18.

Atualização da 4.20 para a 4.21

A política de imagem de cluster openshift ficou disponível de forma geral na versão 4.21. Como resultado, as assinaturas Sigstore para as imagens quay.io/openshift-release-dev/ocp-release passam agora a ser necessárias para a verificação da versão. Se tentares atualizar para a versão 4.21, um "Este cluster tem espelhos configurados. 4.21 vai exigir assinaturas Sigstore..." A mensagem bloqueia a atualização. Para clusters Azure Red Hat OpenShift, não é necessária qualquer ação adicional porque o serviço já fornece as imagens de assinatura Sigstore necessárias.

Para prosseguir com a atualização, forneça o reconhecimento 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ó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.