Planificar un conjunto de restauraciones

En este documento se describe cómo crear, editar y eliminar un plan de restauración en Google Distributed Cloud (GDC) aislado.

Los planes de restauración son situaciones de restauración preconfiguradas para una línea de copias de seguridad correspondiente. Los planes de restauración pueden asignar permisos a los usuarios con el rol de creador de copias de seguridad para que usen estas configuraciones.

Los creadores de copias de seguridad pueden restaurar una copia de seguridad de forma rápida e independiente cuando se produce un incidente. Por ejemplo, los datos persistentes pueden dañarse debido a una actualización de software en una aplicación desplegada, lo que hace que el espacio de nombres de la aplicación no sea válido y que sea necesario restaurarlo.

Durante la restauración, puedes aplicar un conjunto de reglas de sustitución que se usan para buscar un conjunto de recursos y sustituir el valor actual de un atributo de esos recursos por un valor nuevo. Por ejemplo, una regla de sustitución puede cambiar el espacio de nombres de los recursos de la copia de seguridad durante la restauración para migrar una carga de trabajo de un espacio de nombres a otro.

Antes de empezar

Solicitar roles de gestión de identidades y accesos

Para crear un plan de restauración, pide al administrador de la organización de gestión de identidades y accesos que te asigne el rol de administrador de copias de seguridad de clústeres de usuarios (user-cluster-backup-admin). Este rol crea, obtiene, muestra, monitoriza, actualiza, parchea y elimina recursos de copia de seguridad, como planes de copia de seguridad y planes de restauración, en clústeres de usuarios.

Si eres operador de aplicaciones, pide a un administrador con privilegios de administrador de copias de seguridad de clústeres de usuarios que cree un plan de restauración para ti.

Crear un plan de restauración

Crea un plan de restauración con la consola de GDC o la API.

Consola

  1. Inicia sesión en la consola de GDC.
  2. En el menú de navegación, haz clic en Copia de seguridad de clústeres.
  3. Haz clic en Crear plan de restauración.
  4. En la sección Información básica del plan de restauración, sigue estos pasos y haz clic en Siguiente:
    1. En Restore plan name (Nombre del plan de restauración), introduce el nombre de tu plan de restauración.
    2. (Opcional) En Descripción del plan de restauración, introduce una descripción del plan de restauración.
    3. En la lista Source cluster (Clúster de origen), elige el clúster de origen del plan de restauración.
    4. En la lista Proyecto, elige el proyecto del plan de restauración.
    5. Selecciona el proyecto que está adjunto al clúster de origen.
    6. En el campo Plan de copia de seguridad, elige un plan de copia de seguridad de un clúster que corresponda a las copias de seguridad que quieras restaurar.
    7. En el campo Clúster de destino, elige el clúster de destino en el que quieras restaurar la copia de seguridad.
  5. En la sección Choose namespaced resources (Elegir recursos con espacio de nombres), sigue estos pasos y haz clic en Next (Siguiente):
    1. Elige qué espacios de nombres quieres restaurar:
      1. Haz clic en Selected namespaced resources (Recursos con espacio de nombres seleccionados) para especificar los espacios de nombres de la copia de seguridad que quieras restaurar.
        1. Haz clic en Editar espacios de nombres de clúster y, a continuación, en Añadir espacio de nombres de clúster para introducir un espacio de nombres.
      2. Haz clic en Aplicaciones protegidas seleccionadas para añadir recursos especificando el espacio de nombres y el nombre de la aplicación.
    2. Elige cómo gestionar los conflictos:
      1. Haz clic en Error en caso de conflicto (no destructivo) para que la restauración falle si ya hay espacios de nombres en el clúster de destino que se hayan restaurado a partir de una copia de seguridad.
      2. Haz clic en Rollback (destructive) (Restauración destructiva) para eliminar los espacios de nombres que ya haya antes de restaurar los nuevos si ya hay espacios de nombres que se van a restaurar desde una copia de seguridad en el clúster de destino.
    3. Elige cómo restaurar los datos del volumen:
      1. Haz clic en Aprovisionar nuevos volúmenes y restaurar datos de volumen de la copia de seguridad para restaurar los datos de volumen de la copia de seguridad en un nuevo disco persistente.
      2. Haz clic en No restaurar datos de volumen para aprovisionar un nuevo volumen persistente. Si el clúster de destino contiene un volumen persistente no vinculado que cumple los requisitos de PersistentVolumeClaim, el clúster se vincula al volumen.
      3. Haz clic en Reutilizar volúmenes que ya contienen tus datos para no restaurar los datos de la copia de seguridad del volumen. Los PersistentVolumeClaims están vinculados a volúmenes que hacen referencia a discos persistentes.
  6. Opcional: En la sección Elegir recursos de clúster, sigue estos pasos y haz clic en Siguiente:
    1. Haz clic en No restaurar recursos de clúster para dejar intacta la versión actual del recurso.
    2. Haz clic en Restaurar recursos de clúster por GroupKind para restaurar estos recursos.
      1. Haz clic en Editar GroupKinds para añadir más recursos de clúster. Introduce el grupo de APIs y el tipo de objeto para que coincidan con los recursos de esos tipos.
    3. Haz clic en Conservar recursos actuales para crear recursos si no existen en el clúster de destino.
    4. Haz clic en Sobrescribir recursos en el clúster de destino para eliminar un recurso si ya existe en el clúster de destino y restaurar la copia de la copia de seguridad.
  7. Opcional: En la sección Añadir reglas de sustitución, sigue estos pasos y haz clic en Siguiente:
    1. Haz clic en Añadir nueva regla.
    2. En el cuadro Espacios de nombres de clúster, escribe una lista de espacios de nombres para que coincidan con los recursos de esos espacios de nombres.
    3. Para añadir GroupKinds, haz clic en Añadir GroupKind e introduce el grupo de APIs y el tipo de objeto para que coincidan con los recursos de esos tipos.
    4. En el campo Ruta JSON, escribe la ruta JSON que identifica los campos de los recursos que coinciden con los que se aplica la sustitución.
    5. En el campo Patrón de valor original, escribe el patrón original que se comparará con el valor nuevo.
    6. En el campo Valor nuevo, escribe el nuevo valor que sustituirá al valor actual de los atributos que coincidan.
    7. Haz clic en Guardar.
  8. Haz clic en Crear.

API

Crea un recurso personalizado ClusterRestorePlan para planificar restauraciones a partir de un ClusterBackupPlan. El ClusterRestorePlan asigna el conjunto exacto de recursos y espacios de nombres que un creador de copias de seguridad puede restaurar. Este es un ejemplo de ClusterRestorePlan:

apiVersion: backup.gdc.goog/v1
kind: ClusterRestorePlan
metadata:
  name: RESTORE_PLAN_NAME
  namespace:  PROJECT_NAME
spec:
  targetCluster:
    targetClusterType: UserCluster
    targetClusterName:
      kind: "Cluster"
      name: CLUSTER_NAME
  description: RESTORE_PLAN_DESCRIPTION
  clusterBackupPlanName: CLUSTER_BACKUP_PLAN_NAME
  clusterRestoreConfig:
    volumeDataRestorePolicy: RestoreVolumeDataFromBackup
    clusterResourceConflictPolicy: UseBackupVersion
    namespacedResourceRestoreMode: DeleteAndRestore
    namespacedResourceRestoreScope:
      selectedNamespaces:
        namespaces: [NAME_SPACE]
    clusterBackupRepositoryRef: CLUSTER_BACKUP_REPOSITORY
    substitutionRules:
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE

Haz los cambios siguientes:

  • Sustituye RESTORE_PLAN_NAME por el nombre de tu plan de restauración.
  • Sustituye PROJECT_NAME por el nombre de tu proyecto de GDC.
  • Sustituye CLUSTER_NAME por el nombre de tu clúster.

En este ejemplo se usan los siguientes valores:


Valor

Atributo

Descripción
targetClusterName Nombre del clúster de origen de un proyecto al que está asociado este plan.
description Descripción proporcionada por el usuario para el propósito de ClusterRestorePlan.
clusterBackupPlanName Nombre de la ClusterBackupPlan que se va a restaurar. El ClusterBackupPlan debe estar en el mismo espacio de nombres que el ClusterRestorePlan.
clusterRestoreConfig Configuración del proceso de restauración.
volumeDataRestorePolicy Especifica una de estas opciones:
  • NoVolumeDataRestoration: No se restauran los PVs ni los PVCs.
  • RestoreVolumeDataFromBackup: se crean nuevos PVs y PVCs a partir de la copia de seguridad.
  • ReuseVolumeHandleFromBackup: crea nuevos PVs, pero intenta restaurar los PVCs usando sus PVs originales. Está pensado para restaurar el mismo clúster del que se hizo la copia de seguridad.
clusterResourceConflictPolicy Especifica el comportamiento para gestionar los conflictos de recursos de clúster, como si el recurso ya existe en el clúster. Especifica uno de estos valores:
  • UseExistingVersion: no sobrescribe los recursos que ya existen si hay un conflicto.
  • UseBackupVersion: elimina y vuelve a crear los recursos de clúster que ya existen durante el conflicto. Los recursos del clúster de destino se sobrescribirán con las versiones de la copia de seguridad. Esta opción es peligrosa y puede provocar una pérdida de datos no deseada si se usa de forma inadecuada. Por ejemplo, si eliminas una definición de recurso personalizado, Kubernetes eliminará todos los recursos personalizados de ese tipo.
namespacedResourceRestoreMode Gestiona la situación en la que los conjuntos de recursos con espacio de nombres que se están restaurando ya existen en el clúster de destino. Especifica una de estas opciones:
  • DeleteAndRestore: cuando se detectan recursos de nivel superior que entran en conflicto, como Namespaces o ProtectedApplications, primero se elimina el recurso en conflicto y todos los recursos a los que hace referencia antes de restaurar los recursos de Backup. Usa este modo solo cuando quieras revertir una parte de un clúster a un estado anterior.
  • FailOnConflict: si se detectan recursos de nivel superior en conflicto, como el recurso Namespace o ProtectedApplication, al principio del proceso de restauración o durante este, el Restore falla.
  • MergeSkipOnConflict: si se encuentran recursos en conflicto durante el proceso de restauración, este modo omite la restauración de los recursos en conflicto de la copia de seguridad y continúa restaurando otros recursos que no están en el clúster.
  • MergeReplaceOnConflict: si se detectan recursos en conflicto durante el proceso de restauración, este modo sustituye los recursos en conflicto de la copia de seguridad y sigue restaurando otros recursos que no están en el clúster.
namespacedResourceRestoreScope Especifica qué Namespaces o ProtectedApplications se pueden restaurar.
  • selectedApplications asocia aplicaciones protegidas con esta restauración.
  • selectedNamespaces contiene NAME_SPACE, que especifica el espacio de nombres que se va a restaurar desde la copia de seguridad.
clusterBackupRepositoryRef Especifica el repositorio en el que se almacenarán los recursos de Restore. Este repositorio puede ser diferente del repositorio del que procede la copia de seguridad. El repositorio debe ser un repositorio de ReadWrite en el clúster.
substitutionRules Reglas para sustituir valores en los recursos de Kubernetes de los que se ha hecho una copia de seguridad durante la restauración. Si la lista está vacía, no se sustituirá nada. Las reglas de sustitución se aplican de forma secuencial en el orden definido. Este orden es importante, ya que los cambios que haga una regla pueden influir en la lógica de coincidencia de la regla posterior. Cada regla especifica un target, un originValuePattern que debe coincidir (VALUE_PATTERN) y un newValue (NEW_CONFIG_VALUE) por el que se debe sustituir. El target puede incluir namespaces para definir el ámbito de la regla (NAME_SPACE).

Una vez que se haya creado un ClusterRestorePlan, los usuarios con el rol de creador de copias de seguridad podrán restaurar copias de seguridad manualmente.

Ver un plan de restauración

Ver un plan de restauración con la consola de GDC:

  1. Inicia sesión en la consola de GDC.
  2. En el menú de navegación, haz clic en Copia de seguridad de clústeres.
  3. Haz clic en Seleccionar proyecto para elegir una organización o un proyecto en función de tu rol:
    1. Administrador de copias de seguridad de clústeres de usuarios: selecciona una organización para ver todos los planes de restauración de una organización o selecciona un proyecto para ver todos los planes de restauración de un proyecto.
    2. Creador de copias de seguridad: selecciona un proyecto para ver todos los planes de restauración que contiene.
  4. Haz clic en la pestaña Planes de restauración.
  5. Haz clic en un plan de restauración de la lista para ver sus detalles.

Editar un plan de restauración

Si el repositorio de copias de seguridad asociado al plan de restauración que quieres editar tiene un valor en el campo Clúster vinculado (solo lectura) cuando se crea el plan de restauración, se crea dos veces. El plan de restauración se propaga tanto a los clústeres de lectura y escritura como a los de solo lectura.

Cuando edites el plan de restauración de un repositorio de copias de seguridad que tenga clústeres de lectura y escritura, y de solo lectura, debes editar el plan de restauración que tenga el TARGET CLUSTER definido en el clúster de lectura y escritura.

Editar un plan de restauración con la consola de GDC:

  1. Inicia sesión en la consola de GDC.
  2. En el menú de navegación, haz clic en Copia de seguridad de clústeres.
  3. Haz clic en Seleccionar proyecto para elegir una organización o un proyecto en función de tu rol:
    1. Administrador de copias de seguridad de clústeres de usuarios: selecciona una organización para ver todos los planes de restauración de una organización o selecciona un proyecto para ver todos los planes de restauración de un proyecto.
    2. Creador de copias de seguridad: selecciona un proyecto para ver todos los planes de restauración que contiene.
  4. Haz clic en la pestaña Planes de restauración.
  5. Haz clic en el nombre del plan de restauración que quieras editar.
  6. Haz clic en la pestaña Configuración del plan para ver los campos que se pueden modificar.
  7. Haz clic en el icono de edición situado junto a Recursos de espacio de nombres para editar ese recurso:

    1. En la sección Elegir recursos de espacio de nombres, selecciona los recursos de espacio de nombres de la copia de seguridad que quieras restaurar:

      1. Selecciona Recursos de espacio de nombres seleccionados para restaurar los recursos de los espacios de nombres seleccionados en la copia de seguridad:

        1. Selecciona Editar espacios de nombres de clúster para elegir el espacio de nombres de clúster.
        2. En el campo Cluster namespace 1 (Espacio de nombres de clúster 1), introduce el nombre del espacio de nombres.
        3. Haz clic en el botón Save (Guardar).
      2. Selecciona Aplicaciones protegidas seleccionadas para restaurar los recursos de las aplicaciones protegidas seleccionadas en la copia de seguridad:

        1. Selecciona Editar aplicaciones protegidas para elegir el espacio de nombres y la aplicación protegida.
        2. En el campo Espacio de nombres 1, introduce el nombre del espacio de nombres.
        3. En el campo Aplicación protegida 1, introduce el nombre de la aplicación protegida.
        4. Haz clic en el botón Save (Guardar).
  8. Haz clic en el icono de edición situado junto a Recursos de clúster para editar ese recurso:

    1. Opcional: En la sección Choose cluster-scoped resources (Elegir recursos con permisos de clúster), selecciona los recursos con permisos de clúster que quieras restaurar especificando los grupos de APIs y GroupKinds, y decide cómo se deben resolver los conflictos:

      1. Selecciona No restaurar recursos de clúster para quitar los recursos de clúster del proceso de restauración.
      2. Selecciona Restaurar recursos de clúster por GroupKind para restaurar los recursos según el GroupKind especificado:

      3. Para especificar un GroupKind, haz clic en el botón Editar GroupKind.

      4. Haz clic en el botón Añadir GroupKind.

      5. Introduce el nombre de la GroupKind.

      6. Haz clic en el botón Save (Guardar).

    2. En la sección Gestión de conflictos, determina qué acción se debe realizar si el recurso ya existe en el clúster de destino:

      1. Selecciona Conservar los recursos actuales para crear recursos si aún no existen en el clúster.
      2. Selecciona Sobrescribir recursos actuales para eliminar los recursos que se encuentren y sustituirlos por el recurso restaurado.
    3. Haz clic en el botón Guardar para confirmar los cambios.

  9. En la sección Reglas de sustitución, haz clic en el botón Añadir nueva regla para añadir una regla de sustitución:

    1. En el campo Espacios de nombres del clúster, introduce el nombre del espacio de nombres del clúster al que se aplicará esta regla de sustitución.
    2. Haz clic en el botón Añadir GroupKind para aplicar esta regla a un objeto GroupKind determinado.
    3. En el campo Ruta de JSON, introduce la ruta al atributo de recurso que quieras sustituir en formato JSON.
    4. En el campo Patrón de valor original, introduzca una expresión regular que coincida con el valor original del atributo.
    5. En el campo Valor nuevo, introduce el valor que sustituirá al campo de destino. Si este campo está en blanco, el campo de destino se eliminará del recurso.
    6. Haz clic en el botón Guardar para terminar de crear la regla de sustitución.
  10. En la sección Reglas de sustitución, haz clic en el icono de edición para modificar una regla de sustitución.

  11. En la sección Reglas de sustitución, haz clic en el icono de eliminar para eliminar una regla de sustitución.

Eliminar un plan de restauración

RestorePlans se puede eliminar a través de la consola de GDC o eliminando el recurso directamente del servidor de la API de Kubernetes. De esta forma, se eliminan todos los artefactos RestorePlan asociados del almacén de objetos.

Consola

  1. Inicia sesión en la consola de GDC.
  2. En el menú de navegación, haz clic en Copia de seguridad de clústeres.
  3. Haz clic en Seleccionar proyecto para elegir una organización o un proyecto en función de tu rol:
    1. Administrador de copias de seguridad de clústeres de usuarios: selecciona una organización para ver todos los planes de restauración de una organización o selecciona un proyecto para ver todos los planes de restauración de un proyecto.
    2. Creador de copias de seguridad: selecciona un proyecto para ver todos sus planes de restauración.
  4. Haz clic en la pestaña Planes de restauración.
  5. Haz clic en el nombre del plan de restauración que quieras eliminar.
  6. Haz clic en el botón Eliminar .
  7. Introduce el nombre del plan de restauración en el campo.
  8. Haz clic en el botón Eliminar para confirmar la eliminación de este plan de restauración.

API

Elimina el recurso del plan de restauración:

kubectl delete clusterRestoreplan RESTORE_PLAN_NAME -n NAMESPACE

Haz los cambios siguientes:

  • RESTORE_PLAN_NAME: el nombre del plan de restauración.
  • NAMESPACE: el espacio de nombres que contiene el plan de restauración.

Siguientes pasos