35 Migração para o Edge 3.4 #

Esta seção explica como migrar os clusters de gerenciamento e downstream do Edge 3.3 para o Edge 3.4.0.

Importante

Sempre faça as migrações de cluster da versão do Z-stream mais recente do Edge 3.3.

Migre sempre para a versão Edge 3.4.0. Para as próximas atualizações após a migração, consulte as seções de cluster de gerenciamento (Capítulo 36, Cluster de gerenciamento) e downstream (Capítulo 37, Clusters downstream).

35.1 Cluster de gerenciamento #

Esta seção aborda os seguintes tópicos:

Seção 35.1.1, “Pré-requisitos”: etapas de pré-requisito para concluir antes de iniciar a migração.

Seção 35.1.2, “Controller de upgrade”: como migrar um cluster de gerenciamento usando o Capítulo 23, Controller de upgrade.

Seção 35.1.3, “Fleet”: como migrar um cluster de gerenciamento usando o Capítulo 8, Fleet.

35.1.1 Pré-requisitos #

35.1.1.1 Fazer upgrade das CRDs do Bare Metal Operator #

Nota

Aplica-se apenas a clusters que exigem upgrade do gráfico do Capítulo 10, Metal³.

O gráfico Helm do Metal³ inclui as CRDs do Bare Metal Operator (BMO) aproveitando o diretório CRD do Helm.

Entretanto, essa abordagem tem algumas limitações, especificamente a incapacidade de fazer upgrade das CRDs nesse diretório usando o Helm. Para obter mais informações, consulte a documentação do Helm.

Como resultado, antes de fazer upgrade do Metal³ para uma versão compatível com o Edge 3.4.0, os usuários devem fazer o upgrade manual das CRDs do BMO subjacentes.

Em uma máquina com o Helm instalado e o kubectl configurado para apontar para o cluster de gerenciamento:

Aplique manualmente as CRDs do BMO:

helm show crds oci://registry.suse.com/edge/charts/metal3 --version 304.0.16+up0.12.6 | kubectl apply -f -

35.1.2 Controller de upgrade #

Importante

O Controller de upgrade oferece suporte a migrações de versão do Edge somente para clusters de gerenciamento não air-gapped.

Os seguintes tópicos são abordados como parte desta seção:

Seção 35.1.2.1, “Pré-requisitos”: pré-requisitos específicos para o Controller de upgrade.

Seção 35.1.2.2, “Etapas de migração”: etapas para migrar o cluster de gerenciamento para uma nova versão do Edge usando o Controller de upgrade.

35.1.2.1 Pré-requisitos #

35.1.2.1.1 Controller de upgrade do Edge 3.4 #

Antes de usar o Controller de upgrade, verifique se ele executa uma versão com capacidade de migração para o lançamento desejado do Edge.

Para fazer isso:

Se você já tem o Controller de upgrade implantado de uma versão anterior do Edge, faça upgrade do respectivo gráfico:

helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/charts/upgrade-controller --version 304.0.1+up0.1.1

Se você não tem o Controller de upgrade implantado, siga a Seção 23.3, “Instalando o Controller de upgrade”.

35.1.2.2 Etapas de migração #

A execução da migração de um cluster de gerenciamento com o Controller de upgrade é basicamente similar à execução de um upgrade.

A única diferença é que o seu UpgradePlan deve especificar a versão de lançamento 3.4.0:

apiVersion: lifecycle.suse.com/v1alpha1
kind: UpgradePlan
metadata:
  name: upgrade-plan-mgmt
  # Change to the namespace of your Upgrade Controller
  namespace: CHANGE_ME
spec:
  releaseVersion: 3.4.0

Para obter informações sobre como usar o UpgradePlan acima para fazer uma migração, consulte Processo de upgrade do Controller de upgrade (Seção 36.1, “Controller de upgrade”).

35.1.3 Fleet #

Nota

Sempre que possível, siga as instruções da Seção 35.1.2, “Controller de upgrade” para a migração.

Consulte esta seção apenas para casos de uso não cobertos pelo Controller de upgrade.

A execução da migração de um cluster de gerenciamento com o Fleet é basicamente similar a de um upgrade.

As principais diferenças são:

As instâncias do Fleet devem ser usadas a partir da versão release-3.4.0 do repositório suse-edge/fleet-examples.
O upgrade dos gráficos agendados deve ser feito para versões compatíveis com o Edge 3.4.0. Para ver a lista de componentes do Edge 3.4.0, consulte a Seção 53.3, “Versão 3.4.0”.

Importante

Para garantir a migração bem-sucedida do Edge 3.4.0, é importante que os usuários sigam os pontos descritos anteriormente.

Considerando os pontos acima, os usuários podem seguir a documentação do Fleet sobre cluster de gerenciamento (Seção 36.2, “Fleet”) para obter um guia completo das etapas necessárias à migração.

35.2 Clusters downstream #

Seção 35.2.1, “Fleet”: como migrar um cluster downstream usando o Capítulo 8, Fleet.

35.2.1 Fleet #

A execução da migração de um cluster downstream com o Fleet é basicamente similar a de um upgrade.

As principais diferenças são:

As instâncias do Fleet devem ser usadas a partir da versão release-3.4.0 do repositório suse-edge/fleet-examples.
O upgrade dos gráficos agendados deve ser feito para versões compatíveis com o Edge 3.4.0. Para ver a lista de componentes do Edge 3.4.0, consulte a Seção 53.3, “Versão 3.4.0”.

Importante

Para garantir a migração bem-sucedida do Edge 3.4.0, é importante que os usuários sigam os pontos descritos anteriormente.

Considerando os pontos acima, os usuários podem seguir a documentação do Fleet sobre cluster downstream (Seção 37.1, “Fleet”) para obter um guia completo das etapas necessárias à migração.