Cómo restablecer un clúster de AlloyDB Omni con pgBackRest

En esta página, se muestra cómo restablecer un clúster de AlloyDB Omni con una copia de seguridad creada con pgBackRest, la solución de copia de seguridad de código abierto incluida con el contenedor de Docker de AlloyDB Omni.

Debido a que AlloyDB Omni es compatible con PostgreSQL, los comandos y las técnicas de restablecimiento de datos que se describen en el manual de pgBackRest también se aplican a AlloyDB Omni. En esta página, se muestra una selección de tareas de recuperación comunes, con ejemplos de comandos relevantes.

Para obtener más información sobre cómo configurar pgBackRest para que funcione con AlloyDB Omni, consulta Configura pgBackRest para AlloyDB Omni.

Consulta Cómo crear copias de seguridad y restablecer en Kubernetes para obtener información basada en Kubernetes.

Antes de comenzar

Antes de configurar AlloyDB Omni para que funcione con pgBackrest, debes tener AlloyDB Omni instalado y en ejecución en un servidor que controles.

  • Un servidor de base de datos de destino que ejecute la misma versión principal de AlloyDB Omni que la copia de seguridad que deseas restablecer. Para obtener más información sobre cómo instalar AlloyDB Omni, consulta Cómo instalar AlloyDB Omni.

  • Un repositorio de copias de seguridad de pgBackRest que contenga al menos una copia de seguridad de la base de datos de AlloyDB Omni de origen

  • Suficiente espacio en el disco libre en el servidor de destino para contener la base de datos restablecida

Descripción general

Para realizar un restablecimiento de AlloyDB Omni con pgBackRest, ejecuta el comando pgbackrest restore. Los parámetros que le proporcionas al comando varían según tu situación.

En general, debes ejecutar el comando pgbackrest restore con marcas que proporcionan la siguiente información:

  • La ubicación de tu archivo pgbackrest.conf.
  • Es el nombre del repositorio de copias de seguridad de pgBackRest al que deseas restablecer. Estos repositorios se nombran y definen en el archivo pgbackrest.conf.
  • Es la ubicación en el sistema de archivos local a la que se escribirán los datos restablecidos.
  • Un identificador de la copia de seguridad o el momento en particular desde el que deseas restablecer.

Cuando ejecutes los comandos pgbackrest restore en contenedores, recuerda usar las rutas de acceso del sistema de archivos desde el punto de vista del contenedor. Por ejemplo, la ruta de acceso al directorio de datos de AlloyDB Omni siempre es /var/lib/postgresql/data, independientemente de su ubicación en el servidor host. Para obtener más información, consulta Nota sobre las rutas de acceso del sistema de archivos.

Realiza un restablecimiento de un momento determinado

En este ejemplo, se restablecen datos de un repositorio de pgBackRest y se asigna un nombre a un momento determinado para restablecerlos. Si definiste varios repositorios en el archivo pgbackrest.conf del entorno de destino, pgBackRest elige el repositorio desde el que se restablecerá en función de la disponibilidad, la velocidad esperada y otros factores.

En el ejemplo, se da por sentado lo siguiente:

  • Tienes un archivo pgbackrest.conf ubicado en el nivel superior del directorio de datos de AlloyDB Omni de destino. Esto hace que el archivo esté disponible para el pgbackrest creado en contenedor como /var/lib/postgresql/data.

  • Habilitaste las copias de seguridad continuas con tu configuración de pgBackRest.

  1. En el entorno de destino, realiza un restablecimiento de PITR y especifica una marca de tiempo para el restablecimiento:

    docker exec CONTAINER_NAME pgbackrest \
  --config-path=/var/lib/postgresql/data \
  --stanza=STANZA \
  --type=time \
  --pg1-path=/var/lib/postgresql/data/data-RESTORED \
  --target="TIMESTAMP" \
  restore

    Reemplaza lo siguiente:

    • CONTAINER_NAME: El nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste, por ejemplo, my-omni.

    • STANZA: Es la estrofa de configuración, definida por el archivo pgbackrest.conf, que se aplicará a este restablecimiento, por ejemplo, omni.

    • TIMESTAMP: Es la hora a la que se debe restablecer, por ejemplo, 2024-02-22 19:50:00.

  2. En el entorno de destino, detén el contenedor con el siguiente comando:

    docker container stop CONTAINER_NAME

  3. Como medida de precaución, cambia el nombre del subdirectorio data de tu directorio de datos:

    cd DATA_DIR
sudo mv data data-OLD

    Reemplaza DATA_DIR por la ruta de acceso del sistema de archivos al directorio de datos de AlloyDB Omni.

  4. Mueve los datos restablecidos a su lugar y limpia postgresql.auto.conf:

    sudo mv data-RESTORED data
sudo sed -i 's|data-RESTORED|data|' data/postgresql.auto.conf

  5. Inicia el contenedor de AlloyDB Omni con el servidor de base de datos:

    docker container start CONTAINER_NAME

Ahora puedes conectarte a tu base de datos con psql y confirmar que los datos se restablecieron como esperabas. Si es así, puedes borrar la copia de data-OLD del subdirectorio data que creaste antes.

Para obtener más información sobre la PITR en pgBackRest, consulta Recuperación de un momento determinado. Para obtener más información sobre cómo preparar un archivo pgbackrest.conf para usarlo con AlloyDB Omni, consulta Cómo configurar pgBackRest para AlloyDB Omni.

Otras opciones

El comando pgbackrest restore es muy flexible, con un conjunto de opciones y funciones que puedes controlar pasando diferentes opciones de línea de comandos. Se incluyen las siguientes:

  • Limitar un restablecimiento solo a los archivos modificados
  • Restablecer solo las bases de datos seleccionadas

Para obtener una guía completa sobre cómo realizar restablecimientos en pgBackRest, consulta Restablece.