34 Migración a Edge 3.3 #

En esta sección se explica cómo migrar los clústeres de gestión y descendentes de Edge 3.2 a Edge 3.3.0.

Importante

Realice siempre las migraciones de clústeres desde la última versión z-stream de Edge 3.2.

Migre siempre a la versión Edge 3.3.0. Para actualizaciones posteriores a la migración, consulte las secciones sobre los clústeres de gestión (Capítulo 35, Clúster de gestión) y los clústeres descendentes (Capítulo 36, Clústeres descendentes).

34.1 Clúster de gestión #

En esta sección se tratan los temas siguientes:

Sección 34.1.1, “Requisitos previos”: pasos previos que deben completarse antes de iniciar la migración.

Sección 34.1.2, “Upgrade Controller”: cómo migrar un clúster de gestión con Capítulo 23, Upgrade Controller.

Sección 34.1.3, “Fleet”: cómo migrar un clúster de gestión con Capítulo 8, Fleet.

34.1.1 Requisitos previos #

34.1.1.1 Actualización de las CRD del operador bare metal #

Nota

Solo se aplica a clústeres que requieren una actualización del chart de Capítulo 10, Metal³.

El chart de Helm de Metal³ incluye las CRD de Bare Metal Operator (BMO) obtenidas del directorio CRD de Helm.

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

Como resultado, antes de actualizar Metal³ a una versión compatible de Edge 3.3.0, los usuarios deben actualizar manualmente las CRD de BMO subyacentes.

En un equipo con Helm instalado y kubectl configurado que apunte al clúster de gestión:

Aplique manualmente las CRD de BMO:

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

34.1.2 Upgrade Controller #

Importante

Upgrade Controller actualmente solo admite migraciones de versiones de Edge para clústeres de gestión en entornos que no sean aislados.

En esta sección se tratan los siguientes temas:

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

Sección 34.1.2.2, “Pasos de la migración”: pasos para migrar un clúster de gestión a una versión nueva de Edge mediante Upgrade Controller.

34.1.2.1 Requisitos previos #

34.1.2.1.1 Upgrade Controller de Edge 3.3 #

Antes de usar Upgrade Controller, debe asegurarse de que está ejecutando una versión que sea compatible con la migración a la versión de Edge deseada.

Para ello:

Si ya ha desplegado Upgrade Controller desde una versión anterior de Edge, actualice su chart:

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

Si no ha desplegado Upgrade Controller, siga la Sección 23.3, “Instalación de Upgrade Controller”.

34.1.2.2 Pasos de la migración #

Migrar un clúster de gestión con Upgrade Controller es básicamente igual a ejecutar una actualización.

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

34.1.3 Fleet #

Nota

Siempre que sea posible, use las instrucciones de la Sección 34.1.2, “Upgrade Controller” para la migración.

Consulte esta sección solo para los casos no cubiertos por la migración con Upgrade Controller.

Migrar un clúster de gestión con Fleet es básicamente igual a ejecutar una actualización.

Estas son las diferencias principales:

Fleet se debe usar desde la versión release-3.3.0 del repositorio suse-edge/fleet-examples.
Los charts cuya actualización esté programada, deben actualizarse a versiones compatibles con la versión Edge 3.3.0. Para ver una lista de los componentes de Edge 3.3.0, consulte la Sección 52.4, “Versión 3.3.0”.

Importante

Para garantizar que la migración a Edge 3.3.0 se realice correctamente, es importante que los usuarios cumplan con los puntos descritos anteriormente.

Teniendo en cuenta los puntos anteriores, los usuarios pueden seguir la documentación de Fleet (Sección 35.2, “Fleet”) sobre el clúster de gestión, que incluye todos los pasos necesarios para realizar la migración.

34.2 Clústeres descendentes #

Sección 34.2.1, “Fleet”: cómo migrar un clúster descendente con Capítulo 8, Fleet.

34.2.1 Fleet #

Migrar un clúster descendente con Fleet es básicamente igual a ejecutar una actualización.

Estas son las diferencias principales:

Fleet se debe usar desde la versión release-3.3.0 del repositorio suse-edge/fleet-examples.
Los charts cuya actualización esté programada, deben actualizarse a versiones compatibles con la versión Edge 3.3.0. Para ver una lista de los componentes de Edge 3.3.0, consulte la Sección 52.4, “Versión 3.3.0”.

Importante

Para garantizar que la migración a Edge 3.3.0 se realice correctamente, es importante que los usuarios cumplan con los puntos descritos anteriormente.

Teniendo en cuenta los puntos anteriores, los usuarios pueden seguir la documentación de Fleet (Sección 36.1, “Fleet”) sobre los clústeres descendentes para obtener una guía completa sobre los pasos necesarios para realizar la migración.