34 Migração do Edge 3.3 #

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

Importante

Faça sempre as migrações de cluster da versão Z-stream mais recente do Edge 3.2.

Migre sempre para a versão Edge 3.3.0. Para os upgrades pós-migração subsequentes, consulte as seções referentes ao cluster de gerenciamento (Capítulo 35, Cluster de gerenciamento) e downstream (Capítulo 36, Clusters downstream).

34.1 Cluster de gerenciamento #

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

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

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

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

34.1.1 Pré-requisitos #

34.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 do Edge 3.3.0, os usuários devem fazer upgrade manual das CRDs subjacentes do BMO.

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 303.0.7+up0.11.5 | kubectl apply -f -

34.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 34.1.2.1, “Pré-requisitos”: pré-requisitos específicos para o Controller de upgrade.

Seção 34.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.

34.1.2.1 Pré-requisitos #

34.1.2.1.1 Controller de upgrade do Edge 3.3 #

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 303.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”.

34.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 UpgradePlan deve especificar a versão de lançamento 3.3.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.3.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 35.1, “Controller de upgrade”).

34.1.3 Fleet #

Nota

Sempre que possível, siga as instruções da Seção 34.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.3.0 do repositório suse-edge/fleet-examples.
Os gráficos programados para upgrade devem ser atualizados para versões compatíveis com o Edge 3.3.0. Para ver uma lista de componentes do Edge 3.3.0, consulte a Seção 52.4, “Versão 3.3.0”.

Importante

Para garantir a migração bem-sucedida do Edge 3.3.0, é importante que os usuários cumpram os pontos descritos acima.

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

34.2 Clusters downstream #

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

34.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.3.0 do repositório suse-edge/fleet-examples.
Os gráficos programados para upgrade devem ser atualizados para versões compatíveis com o Edge 3.3.0. Para ver uma lista de componentes do Edge 3.3.0, consulte a Seção 52.4, “Versão 3.3.0”.

Importante

Para garantir a migração bem-sucedida do Edge 3.3.0, é importante que os usuários cumpram os pontos descritos acima.

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