Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Faça upgrade de v1.6.x para v1.6.y

Informações gerais

Um Botão de Fazer upgrade aparece na tela Dashboard sempre que uma nova SUSE Virtualization versão que você pode fazer upgrade se torna disponível. Para mais informações, veja Iniciar upgrade.

Para informações sobre como fazer upgrade SUSE Virtualization em ambientes air-gapped, veja Preparar um upgrade em ambientes air-gapped.

Atualize a extensão da UI do Harvester em SUSE Rancher Prime v2.12

Você deve usar uma versão compatível (v1.6.x) da Extensão da UI do Harvester para importar clusters SUSE Virtualization v1.6.x no Rancher v2.12.

  1. Na UI do Rancher, vá para local → Apps → Repositórios.

  2. Localize o repositório chamado harvester, e então selecione ⋮ → Atualizar.

  3. Vá para a tela Extensões.

  4. Localize a extensão chamada Harvester, e então clique em Atualizar.

  5. Selecione uma versão compatível, e então clique em Atualizar.

  6. Permita algum tempo para que a extensão seja atualizada, e então atualize a tela.

Problemas conhecidos

O processo de fazer upgrade está preso no estado "Pré-drenado"

Em certas situações, o Gerenciador de Instâncias pode falhar em limpar uma instância de engine, mesmo após o estado do CR da engine ter mudado para "Parado". O processo de fazer upgrade fica preso no estado "Pré-drenado" porque o pod do gerenciador de instâncias não pode ser excluído enquanto o correspondente PodDisruptionBudget (PDB) ainda existir.

A solução alternativa é excluir o PDB do gerenciador de instâncias após garantir que todos os volumes estejam saudáveis.

Problemas relacionados: #8977 e #11605

O cluster convidado está preso no estado "Atualizando"

Um RKE2 cluster convidado pode ficar preso no estado "Atualizando" após SUSE Virtualization ser feito upgrade. A seguinte mensagem de erro é exibida na interface do usuário SUSE Virtualization:

Configuring etcd node(s) rke2-pool1-xdvfc-qf4vb: Node condition MemoryPressure is Unknown. Node condition DiskPressure is Unknown. Node condition PIDPressure is Unknown. Node condition Ready is Unknown, waiting for probes: calico, etcd, kube-apiserver, kube-controller-manager

O problema ocorre quando o endereço IP do nó convidado muda após o fazer upgrade, causando mau funcionamento do etcd. É provável que a máquina virtual subjacente tenha sido reiniciada várias vezes e recebido um novo endereço IP do servidor DHCP.

Para resolver o problema, execute os seguintes passos:

  1. Na interface do usuário Rancher, exclua o nó que causa o erro do cluster convidado.

  2. Na interface do usuário SUSE Virtualization, verifique o status da máquina virtual subjacente.

  3. Se necessário, reinicie a máquina virtual.

A máquina virtual é removida e o cluster convidado tenta criar um novo nó. Uma vez que o nó é criado, o status do cluster convidado muda para "Ativo".

Problema relacionado: #8950

Máquina virtual que estava parada está presa no estado "Iniciando".

Um volume SUSE Storage pode oscilar entre os estados "Desanexando" e "Desanexado" após uma migração ao vivo. Como o volume não está pronto, a máquina virtual associada não consegue iniciar completamente.

A solução alternativa é limpar o status.currentMigrationNodeID do volume usando o seguinte comando:

kubectl patch -n longhorn-system volume <volume> \
  --type=merge \
  --subresource status \
  -p '{"status":{"currentMigrationNodeID":""}}'

Problemas relacionados: #8949 e #11479

4. Fazer upgrade para v1.6.1-rc2 preso no estado "Pré-drenado"

O processo de fazer upgrade pode ficar preso indefinidamente no estado "Pré-drenado" se o seguinte caminho de upgrade específico for seguido:

  • O cluster foi primeiro submetido ao fazer upgrade de v1.5.1 para v1.6.0.

  • É tentado um processo de fazer upgrade subsequente de v1.6.0 para v1.6.1-rc2.

Você pode ver a seguinte mensagem de erro ao verificar o controlador SUSE Virtualization:

harvester-899b4df79-mzgkx apiserver time="2025-10-11T07:21:17Z" level=error msg="error syncing 'fleet-local/custom-a8796656aa4c-machine-plan': handler harvester-upgrade-secret-controller: jobs.batch \"hvst-upgrade-7zqp7-post-drain-hp-113-tink-system\" already exists, requeuing"
harvester-899b4df79-mzgkx apiserver time="2025-10-11T07:23:17Z" level=error msg="error syncing 'fleet-local/custom-a8796656aa4c-machine-plan': handler harvester-upgrade-secret-controller: jobs.batch \"hvst-upgrade-7zqp7-post-drain-hp-113-tink-system\" already exists, requeuing"
harvester-899b4df79-mzgkx apiserver time="2025-10-11T07:25:17Z" level=error msg="error syncing 'fleet-local/custom-a8796656aa4c-machine-plan': handler harvester-upgrade-secret-controller: jobs.batch \"hvst-upgrade-7zqp7-post-drain-hp-113-tink-system\" already exists, requeuing"

Esta é uma falha de sincronização rara: o trabalho já foi criado, mas o objeto de fazer upgrade não foi atualizado.

A solução alternativa é excluir o trabalho pós-drain existente e, em seguida, aguardar o Upgrade Controller recriá-lo.

Problema relacionado: #9293