documentation.suse.com / Documentação do SUSE Edge / Operações de dia 2 / Migração do Edge 3.3

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
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
Nota

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

O gráfico Helm do Metal3 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 Metal3 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:

  1. 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
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:

  1. 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

  2. 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
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:

  1. As instâncias do Fleet devem ser usadas a partir da versão release-3.3.0 do repositório suse-edge/fleet-examples.

  2. 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
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:

  1. As instâncias do Fleet devem ser usadas a partir da versão release-3.3.0 do repositório suse-edge/fleet-examples.

  2. 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
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.

Documentation survey