|Index|SUSE Telco Cloud Documentação|Operações do Dia Dois|Migração Edge 3.6
Aplica-se a SUSE Telco Cloud 3.6

57 Migração Edge 3.6

 

Esta seção explica como migrar seus clusters management e downstream de SUSE Telco Cloud 3.5 para SUSE Telco Cloud 3.6.0.

Importante
Importante

Sempre realize migrações de cluster a partir da latest Z-stream release do SUSE Telco Cloud 3.5.

Sempre migre para a SUSE Telco Cloud 3.6.0 release. Para upgrades pós-migração subsequentes, consulte as management (Capítulo 58, Cluster de gerenciamento) seções.

A tabela a seguir lista os diferentes tipos de clusters e os métodos para fazer upgrade dos clusters:

Tabela 57.1: Clusters e métodos para fazer upgrade de clusters downstream
 
Tipo de clusterMétodo

Clusters provisionados por EIB

Consulte Seção 57.1.3, “Fleet” para obter os detalhes.

Clusters provisionados por Metal3

Consulte atualizações de cluster downstream (Seção 59.3, “Upgrades de clusters downstream”) para obter detalhes.

57.1 Cluster de gerenciamento

 

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

Seção 57.1.1, “Pré-requisitos” - etapas de pré-requisito a serem concluídas antes de iniciar a migração.

Seção 57.1.2, “Upgrade Controller” - como fazer uma migração de cluster management usando o Capítulo 21, Upgrade Controller.

Seção 57.1.3, “Fleet” - como fazer uma migração de cluster management usando Capítulo 9, Fleet.

57.1.1 Pré-requisitos

 

57.1.1.1 Atualize os CRDs do Bare Metal Operator

 
Nota
Nota

Aplica-se apenas a clusters de gerenciamento CAPI/Metal3 que exigem uma atualização de gráfico Capítulo 11, Metal3.

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

No entanto, essa abordagem tem certas limitações, particularmente a incapacidade de atualizar CRDs neste diretório usando o Helm. Para obter mais informações, consulte a documentação do Helm.

Como resultado, antes de atualizar o Metal3 para uma versão compatível com SUSE Telco Cloud 3.6.0, os usuários devem atualizar manualmente os CRDs do BMO subjacentes.

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

  1. Aplique manualmente os CRDs do BMO:

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

57.1.1.2 Migrar a configuração do certificado de CA do Metal3

 
Nota
Nota

Aplica-se apenas a implantações do Metal3 que usam CAs confiáveis adicionais para servidores de mídia externos com TLS.

O gráfico Helm do Metal3 mudou a forma como os certificados de CA confiáveis são configurados. Anteriormente, as CAs adicionais eram fornecidas por meio de um Secret (tls-ca-additional) com o sinalizador booleano additionalTrustedCAs. A nova versão usa um ConfigMap contendo o pacote de CA completo referenciado pelo valor global.trustedCAs.

Se você configurou CAs confiáveis adicionais para o Metal3, você precisa migrar da abordagem baseada em Secret para a abordagem baseada em ConfigMap:

  1. Crie um ConfigMap contendo seu pacote de CA a partir do Secret existente:

    Extraia os certificados do Secret antigo:

    kubectl get secret tls-ca-additional -n metal3-system -o jsonpath='{.data}' | \
  jq -r 'to_entries[] | .value' | base64 -d > ca-bundle.pem

    Opcional - Inclua o pacote de CA do sistema: Se sua implantação do Metal3 também precisar confiar em CAs públicas (por exemplo, ao acessar recursos externos via HTTPS), você precisará incluir o pacote de CA do sistema além de suas CAs personalizadas. Extraia o pacote de CA do sistema de uma imagem de contêiner e adicione-o antes de suas CAs personalizadas:

    # Extract system CAs from a container image (using podman or docker)
podman run --rm registry.suse.com/bci/bci-base:latest cat /etc/ssl/certs/ca-certificates.crt > system-cas.pem

# Combine system CAs with your custom CAs
cat system-cas.pem ca-bundle.pem > combined-ca-bundle.pem
mv combined-ca-bundle.pem ca-bundle.pem
    Importante
    Importante

    Se você incluir o pacote de CA do sistema, torna-se sua responsabilidade mantê-lo atualizado. As CAs do sistema na imagem do contêiner podem ficar obsoletas com o tempo, à medida que os certificados de CA expiram ou são revogados. Você deve atualizar periodicamente o pacote de CA do sistema extraindo-o novamente de uma imagem de contêiner atualizada.

    Crie o ConfigMap com o pacote de CA final:

    kubectl create configmap tls-ca-bundle -n metal3-system --from-file=ca-bundle.pem=ca-bundle.pem

  2. Atualize seus valores de Helm do Metal3 para usar a nova referência do ConfigMap:

    Altere de:

    global:
  additionalTrustedCAs: true

    Para:

    global:
  trustedCAs: tls-ca-bundle

  3. Após atualizar o gráfico Helm do Metal3 com a nova configuração, você pode excluir o Secret antigo:

    kubectl delete secret tls-ca-additional -n metal3-system

57.1.2 Upgrade Controller

 
Importante
Importante

O Upgrade Controller atualmente suporta migrações de versão SUSE Telco Cloud apenas para clusters de gerenciamento que não são air-gapped.

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

Seção 57.1.2.1, “Pré-requisitos” - pré-requisitos específicos para o Upgrade Controller.

Seção 57.1.2.2, “Etapas de migração” - etapas para migrar um cluster management para uma nova versão SUSE Telco Cloud usando o Upgrade Controller.

57.1.2.1 Pré-requisitos

 
57.1.2.1.1 SUSE Telco Cloud 3.6 Upgrade Controller
 

Antes de usar o Upgrade Controller, você deve primeiro garantir que ele esteja executando uma versão capaz de migrar para a versão SUSE Telco Cloud desejada.

Para fazer isso:

  1. Se você já tiver o Upgrade Controller implantado a partir de uma versão SUSE Telco Cloud anterior, atualize seu gráfico:

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

  2. Se você não tiver Upgrade Controller implantado, siga Seção 21.3, “Instalando o Upgrade Controller”.

57.1.2.2 Etapas de migração

 

Realizar uma migração de cluster management com o Upgrade Controller é fundamentalmente semelhante à execução de um upgrade.

A única diferença é que seu UpgradePlan deve especificar a versão de lançamento 3.6.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.6.0

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

57.1.3 Fleet

 
Nota
Nota

Sempre que possível, use o Seção 57.1.2, “Upgrade Controller” para migração.

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

Realizar uma migração de cluster management com Fleet é fundamentalmente semelhante à execução de um upgrade.

As principais diferenças são:

  1. As frotas devem ser usadas a partir da versão release-3.6.0 do repositório suse-edge/fleet-examples.

  2. Os gráficos agendados para um upgrade devem ser atualizados para versões compatíveis com a versão SUSE Telco Cloud 3.6.0. Para obter uma lista dos componentes SUSE Telco Cloud 3.6.0, consulte Seção 75.4, “Release 3.6.0”.

Importante
Importante

Para garantir uma migração SUSE Telco Cloud 3.6.0 bem-sucedida, é importante que os usuários cumpram os pontos descritos acima.

57.2 Clusters downstream

 

Seção 57.2.1, “Fleet” - como fazer uma migração de cluster downstream usando Capítulo 9, Fleet.

57.2.1 Fleet

 

Realizar uma migração de cluster downstream com Fleet é fundamentalmente semelhante à execução de um upgrade.

As principais diferenças são:

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

  2. Os gráficos agendados para um upgrade devem ser atualizados para versões compatíveis com a versão SUSE Telco Cloud 3.6.0. Para obter uma lista dos componentes SUSE Telco Cloud 3.6.0, consulte Seção 75.4, “Release 3.6.0”.

Importante
Importante

Para garantir uma migração SUSE Telco Cloud 3.6.0 bem-sucedida, é importante que os usuários cumpram os pontos descritos acima.