|Index|SUSE Telco Cloud Documentación|Operaciones del día 2|Migración edge 3.6
Se aplica a SUSE Telco Cloud 3.6

57 Migración edge 3.6

 

Esta sección explica cómo migrar sus clústeres management y downstream de SUSE Telco Cloud 3.5 a SUSE Telco Cloud 3.6.0.

Importante
Importante

Realice siempre las migraciones de clúster desde la latest Z-stream release de SUSE Telco Cloud 3.5.

Migre siempre a la SUSE Telco Cloud 3.6.0 release. Para actualizaciones posteriores a la migración, consulte las management (Capítulo 58, Clúster de gestión) secciones.

La siguiente tabla enumera los diferentes tipos de clústeres y los métodos para actualizarlos:

Tabla 57.1: Clústeres y métodos para actualizar clústeres en sentido descendente
 
Tipo de clústerMétodo

Clústeres aprovisionados por EIB

Consulte el Sección 57.1.3, “Fleet” para obtener más información.

Clústeres aprovisionados por Metal3

Consulte Actualizaciones de clúster descendente (Sección 59.3, “Actualizaciones de clústeres descendentes”) para obtener más detalles.

57.1 Clúster de gestión

 

Esta sección cubre los temas siguientes:

Sección 57.1.1, “Requisitos previos” - pasos previos necesarios antes de comenzar la migración.

Sección 57.1.2, “Upgrade Controller” - cómo realizar una migración de clúster management utilizando Capítulo 21, Controlador de actualización.

Sección 57.1.3, “Fleet” - cómo realizar una migración de clúster management utilizando Capítulo 9, Fleet.

57.1.1 Requisitos previos

 

57.1.1.1 Actualice los CRD del Bare Metal Operator

 
Nota
Nota

Se aplica solo a los clústeres de gestión de CAPI/Metal3 que requieren una actualización del gráfico Capítulo 11, Metal3.

El gráfico de Helm Metal3 incluye los CRD de Bare Metal Operator (BMO) aprovechando el directorio CRD de Helm.

Sin embargo, este enfoque tiene ciertas limitaciones, en particular la imposibilidad de actualizar los CRD en este directorio mediante Helm. Para obtener más información, consulte la documentación de Helm.

Como resultado, antes de actualizar Metal3 a una versión compatible con SUSE Telco Cloud 3.6.0, los usuarios deben actualizar manualmente los CRD de BMO subyacentes.

En una máquina con Helm instalado y kubectl configurado para apuntar a su clúster management:

  1. Aplique manualmente los CRD de 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 la configuración del certificado de CA de Metal3

 
Nota
Nota

Se aplica solo a las implementaciones de Metal3 que utilizan CA de confianza adicionales para servidores de medios externos con TLS.

El gráfico de Helm de Metal3 ha cambiado la forma en que se configuran los certificados de CA de confianza. Anteriormente, las CA adicionales se proporcionaban a través de un Secret (tls-ca-additional) con el indicador booleano additionalTrustedCAs. La nueva versión utiliza un ConfigMap que contiene el paquete de CA completo al que hace referencia el valor global.trustedCAs.

Si ha configurado CA de confianza adicionales para Metal3, debe migrar del enfoque basado en Secret al enfoque basado en ConfigMap:

  1. Cree un ConfigMap que contenga su paquete de CA a partir del Secret existente:

    Extraiga los certificados del Secret antiguo:

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

    Opcional: incluya el paquete de CA del sistema: Si el despliegue de Metal3 también necesita confiar en CA públicas (por ejemplo, al acceder a recursos externos a través de HTTPS), debe incluir el paquete de CA del sistema además de sus CA personalizadas. Extraiga el paquete de CA del sistema de una imagen de contenedor y antepóngalo a sus CA 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

    Si incluye el paquete de CA del sistema, es su responsabilidad mantenerlo actualizado. Los certificados de CA del sistema en la imagen de contenedor pueden quedar obsoletos con el tiempo a medida que los certificados de CA caducan o son revocados. Debe actualizar periódicamente el paquete de CA del sistema volviéndolo a extraer de una imagen de contenedor actualizada.

    Cree el ConfigMap con el paquete de CA final:

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

  2. Actualice los valores de Helm de Metal3 para utilizar la nueva referencia de ConfigMap:

    Cambie de:

    global:
  additionalTrustedCAs: true

    A:

    global:
  trustedCAs: tls-ca-bundle

  3. Tras actualizar el gráfico de Helm de Metal3 con la nueva configuración, puede eliminar el Secret antiguo:

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

57.1.2 Upgrade Controller

 
Importante
Importante

Upgrade Controller actualmente solo admite migraciones de versiones de SUSE Telco Cloud para clústeres de gestión no en entorno aislado.

Los siguientes temas se tratan como parte de esta sección:

Sección 57.1.2.1, “Requisitos previos”: requisitos previos específicos para Upgrade Controller.

Sección 57.1.2.2, “Pasos de migración”: pasos para migrar un clúster management a una nueva versión de SUSE Telco Cloud utilizando Upgrade Controller.

57.1.2.1 Requisitos previos

 
57.1.2.1.1 SUSE Telco Cloud 3.6 Upgrade Controller
 

Antes de utilizar Upgrade Controller, debe asegurarse primero de que está ejecutando una versión capaz de migrar a la versión de SUSE Telco Cloud deseada.

Para realizar esta operación:

  1. Si ya tiene Upgrade Controller desplegado desde una versión de SUSE Telco Cloud anterior, actualice su 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. Si no tiene Upgrade Controller desplegado, siga Sección 21.3, “Instalación del Controlador de actualización”.

57.1.2.2 Pasos de migración

 

Realizar una migración de clúster management con Upgrade Controller es fundamentalmente similar a ejecutar una actualización.

La única diferencia es que su UpgradePlan debe especificar la versión de lanzamiento 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 obtener información sobre cómo utilizar el UpgradePlan anterior para realizar una migración, consulte el proceso de actualización del Upgrade Controller (Sección 58.1, “Upgrade Controller”).

57.1.3 Fleet

 
Nota
Nota

Siempre que sea posible, utilice Sección 57.1.2, “Upgrade Controller” para la migración.

Consulte esta sección solo para casos de uso no cubiertos por Upgrade Controller.

Realizar una migración de clúster management con Fleet es fundamentalmente similar a ejecutar una actualización.

Las diferencias clave son que:

  1. Las flotas deben utilizarse desde la versión release-3.6.0 del repositorio suse-edge/fleet-examples.

  2. Los gráficos programados para una actualización deben actualizarse a versiones compatibles con la versión SUSE Telco Cloud 3.6.0. Para obtener una lista de los componentes SUSE Telco Cloud 3.6.0, consulte Sección 75.4, “Versión 3.6.0”.

Importante
Importante

Para garantizar una migración SUSE Telco Cloud 3.6.0 correcta, es importante que los usuarios cumplan los puntos indicados anteriormente.

57.2 Clústeres descendentes

 

Sección 57.2.1, “Fleet” - cómo realizar una migración de clúster downstream utilizando Capítulo 9, Fleet.

57.2.1 Fleet

 

Realizar una migración de clúster downstream con Fleet es fundamentalmente similar a ejecutar una actualización.

Las diferencias clave son que:

  1. Las flotas deben utilizarse desde la versión release-3.6.0 del repositorio suse-edge/fleet-examples.

  2. Los gráficos programados para una actualización deben actualizarse a versiones compatibles con la versión SUSE Telco Cloud 3.6.0. Para obtener una lista de los componentes SUSE Telco Cloud 3.6.0, consulte Sección 75.4, “Versión 3.6.0”.

Importante
Importante

Para garantizar una migración SUSE Telco Cloud 3.6.0 correcta, es importante que los usuarios cumplan los puntos indicados anteriormente.