Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Reversiones

Esta página describe cómo realizar una reversión de Rancher a una versión anterior después de una actualización.

  • This is only possible by restoring to a previous version from a backup instance. Changing versions using kubectl or Helm is not supported.

  • When rolling back, ensure the version being restored is under active support. Rolling back to versions that are end-of-life is not supported. Refer to SUSE’s Product Support Lifecycle page to verify key lifecycle dates for your given version.

Sigue las instrucciones de esta página cuando:

  • La instancia de Rancher en ejecución ha sido actualizada a una versión más reciente después de que se realizó la copia de seguridad.

  • El clúster local es el mismo en el que se realizó la copia de seguridad.

Para realizar una reversión de Rancher a una versión inferior/anterior, utiliza la aplicación Rancher Backups y restaura Rancher desde la copia de seguridad.

Rancher debe iniciarse con la versión anterior después de una reversión.

Una restauración se realiza creando un recurso personalizado de Restauración.

Pasos alternativos para escenarios especiales

Se deben realizar pasos alternativos para las reversiones en los siguientes escenarios:

  • Reversión de v2.14.0 y versiones posteriores a una versión anterior de v2.13.x.

En Rancher v2.13.0, Rancher Turtles se convirtió en el gestor predeterminado para los recursos de CAPI, reemplazando a los controladores de cluster-api previamente integrados, y en Rancher v2.14.0 se eliminó por completo el cluster-api integrado. Como resultado, si revierte de Rancher v2.14.0 y versiones posteriores a una versión anterior de Rancher v2.13.x y no tiene la intención de seguir utilizando Rancher Turtles para gestionar los recursos de CAPI, pueden ser necesarios pasos manuales adicionales para utilizar los controladores de cluster-api integrados. Desde Rancher v2.14.0 en adelante, Rancher Turtles es el único gestor soportado para los recursos de CAPI.

En Rancher v2.14.0, el módulo cluster-api se actualiza de v1.10.6 a v1.12.2. El cluster-api v1.12.2, a su vez, actualiza las apiVersions de sus definiciones de recursos personalizadas (CRDs) de cluster.x-k8s.io/v1beta1 a cluster.x-k8s.io/v1beta2. Los archivos de copia de seguridad de Rancher incluyen CRDs de Cluster API. Al restaurar datos de copia de seguridad de Rancher v2.13.x a un clúster local después de actualizar a v2.14.0, la aplicación de copia de seguridad de Rancher primero restaura los CRDs v1beta1. Esto falla porque la versión v1beta2 no puede ser eliminada de los CRDs mientras los recursos personalizados v1beta2 estén presentes en el clúster.

Importante:

  • Sigue las instrucciones de esta página para restaurar Rancher en el mismo clúster del que se realizó la copia de seguridad. Para migrar Rancher a un nuevo clúster, sigue los pasos para migrar Rancher.

  • Mientras se restaura Rancher en la misma configuración, la ampliación de Rancher se reduce manualmente antes de que comience la restauración, luego el operador la volverá a aumentar una vez que la restauración se complete. Como resultado, Rancher y su interfaz de usuario no estarán disponibles hasta que la restauración esté completa. Mientras la interfaz de usuario no esté disponible, utiliza el kubeconfig del clúster original con el archivo YAML de restauración: kubectl create -f restore.yaml.

Paso 1: Crea el Recurso Personalizado de Restauración

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster local y haz clic en Explorar.

  3. En la barra de navegación izquierda, haz clic en Copias de seguridad de Rancher  Restaurar.

Si la aplicación Copias de seguridad de Rancher no es visible, necesitarás instalarla desde la página de Charts en Aplicaciones. Consulta aquí para más información.

  1. Haga clic en Crear.

  2. Crea la Restauración con el formulario o con YAML. Para obtener ayuda creando el recurso de Restauración utilizando el formulario en línea, consulta la referencia de configuración y los ejemplos.

  3. Para utilizar el editor de YAML, puedes hacer clic en Crear  Crear desde YAML. Ingresa el YAML de Restauración. El siguiente es un ejemplo de recurso personalizado de Restauración:

     apiVersion: resources.cattle.io/v1
 kind: Restore
 metadata:
   name: restore-migration
 spec:
   backupFilename: backup-b0450532-cee1-4aa1-a881-f5f48a007b1c-2020-09-15T07-27-09Z.tar.gz
   encryptionConfigSecretName: encryptionconfig
   storageLocation:
     s3:
       credentialSecretName: s3-creds
       credentialSecretNamespace: default
       bucketName: rancher-backups
       folder: rancher
       region: us-west-2
       endpoint: s3.us-west-2.amazonaws.com

    Para obtener ayuda configurando la Restauración, consulta la referencia de configuración y los ejemplos.

  4. Haga clic en Crear.

Resultado: El archivo de copia de seguridad se crea y se actualiza en la ubicación de almacenamiento objetivo. Los recursos se restauran en este orden:

  1. Definiciones de Recursos Personalizados (CRDs)

  2. Recursos de alcance de clúster

  3. Recursos de espacio de nombres

Para comprobar cómo está progresando la restauración, puedes revisar los registros del operador. Sigue estos pasos para obtener los registros:

kubectl get pods -n cattle-resources-system
kubectl logs -n cattle-resources-system -f

Paso 2: Revertir a una versión anterior de Rancher

Rancher se puede revertir utilizando la CLI de Helm. Para realizar una reversión a la versión anterior:

helm rollback rancher -n cattle-system

Si la revisión anterior no es el objetivo previsto, puedes especificar una revisión a la que realizar la reversión. Para ver el historial de ampliaciones:

helm history rancher -n cattle-system

Cuando se determine la revisión objetivo, realiza la reversión. Este ejemplo revertirá a la revisión 3:

helm rollback rancher 3 -n cattle-system