Restauración desde una copia de seguridad

Puede restaurar una GitHub Enterprise Server instancia desde una copia de seguridad mediante la línea de comandos. El servicio de copia de seguridad admite la restauración completa de instancias, incluidos los datos de configuración y de usuario.

Requisitos de la versión de snapshot

Solo puedes restaurar una instantánea si procede de como máximo dos versiones de características detrás de la versión de la instancia de destino.

Por ejemplo:

• Una instantánea de la versión 3.17 se puede restaurar en un destino que ejecute 3.17.x, 3.18.x o 3.19.x.
• No se puede restaurar una instantánea de la versión 3.17 a la 3.20, que está más de dos versiones adelantada.

Tampoco puedes restaurar desde una versión más reciente a una anterior. Por ejemplo, al intentar restaurar una instantánea 3.18 en una instancia 3.17, se producirá un error: Error: Snapshot can not be restored to an older release of GitHub Enterprise Server.

Requisitos previos

Antes de restaurar una copia de seguridad:

1. Habilita el modo de mantenimiento en la instancia de destino. Consulta Habilitar y programar el modo de mantenimiento.
2. Comprueba el acceso al almacenamiento de copia de seguridad que contiene la instantánea.
3. Pausa los servicios que interfieran: si se usa alta disponibilidad (HA), asegúrate de que la replicación está detenida.
4. Preparación para GitHub Actions : si está habilitada, asegúrese de que la instancia de destino esté configurada con el almacenamiento externo correcto. Consulte Restauración con Acciones de GitHub activadas para obtener más información.

Inicio de la operación de restauración

Para restaurar desde una instantánea:

1. SSH a la instancia de destino como usuario admin.

2. Ejecute uno de los siguientes comandos:

   • Restaura la instantánea más reciente:

     ghe-restore
     

   • Restaura una instantánea específica. Reemplaza <SNAPSHOT_TIMESTAMP> por la marca de tiempo de la instantánea que deseas restaurar (por ejemplo, YYYYMMDDTHHMMSS).

     ghe-restore -s <SNAPSHOT_TIMESTAMP>
     

   • (Opcional) Obligación de reemplazar los datos de configuración, certificados y licencias.

     ghe-restore -c          # Latest snapshot
     ghe-restore -s <SNAPSHOT_TIMESTAMP> -c  # Specific snapshot
     

3. Finalizar en Consola de administración:

   • Revisa todas las opciones de configuración (red, autenticación, TLS, etc.).
   • Haz clic en Guardar configuración para aplicarlas e iniciar servicios.
   • La instancia no está totalmente operativa hasta que se complete este paso.

4. Valida la instancia restaurada para asegurarte de que todo funciona según lo previsto.

5. Si estás usando Alta Disponibilidad (HA), primero completa la restauración en una instancia independiente. A continuación, vuelva a configurar la alta disponibilidad.

   • Si tienes problemas de sincronización (por ejemplo, UUID obsoletos en ghe-repl-status), ejecuta ghe-repl-teardown.
   • Para obtener ayuda, póngase en contacto con Soporte de GitHub.

6. Vuelva a registrar ejecutores autohospedadosGitHub Actions, ya que la restauración invalida los tokens anteriores.

Rotación y retención de instantáneas

Las instantáneas se eliminan automáticamente en función de la configuración de retención:

• Solo se conservan las n instantáneas más recientes (como configuradas).
• Las instantáneas anteriores se eliminan después de cada copia de seguridad correcta.
• Las instantáneas se denominan mediante marcas de tiempo (YYYYMMDDTHHMMSS) para facilitar la referencia.
• Los vínculos físicos se usan para almacenar archivos sin cambios de forma eficaz, a la vez que se conserva la funcionalidad de restauración completa.

Solución de problemas de errores de restauración

Si se produce un error en una operación de restauración, comprueba:

• Integridad de la copia de seguridad: asegúrate de que la instantánea no se interrumpió ni se ha dañado.
• Acceso de almacenamiento: comprueba que la instancia puede montar y leer el volumen de copia de seguridad.
• Error de coincidencia de versiones: confirma que la versión de instantánea es compatible con la instancia de destino.
• Registros : revisa /var/log/github-backup/restore-verbose-[timestamp].log si hay errores.

Si Consola de administración muestra un error genérico, conéctate por SSH a la instancia para acceder a los registros detallados.