Configuración del servicio de copia de seguridad

Antes de configurar el servicio de copia de seguridad, asegúrate de que tienes:

• Una instancia de GitHub Enterprise Server que ejecute la versión 3.17 o posterior.
• Un volumen de almacenamiento dedicado aprovisionado y administrado para su uso como destino de copia de seguridad.

Requisitos de almacenamiento

Para garantizar copias de seguridad confiables y eficaces, el almacenamiento debe cumplir los siguientes requisitos:

•         **Capacidad:** asigne al menos cinco veces la cantidad de almacenamiento que usa el disco del dispositivo de GitHub principal. Toma en cuenta las instantáneas históricas y el crecimiento futuro.
  

•         **Compatibilidad con el sistema de archivos:** el servicio de copia de seguridad usa vínculos físicos para un almacenamiento eficaz y la instancia de GitHub usa vínculos simbólicos. El destino de copia de seguridad debe admitir vínculos simbólicos y físicos, y debe usar un sistema de archivos que distingue mayúsculas de minúsculas para evitar conflictos.
  

  Puedes probar si el sistema de archivos admite enlaces duros a enlaces simbólicos mediante la ejecución de:

  cd /data/backup
  sudo touch file
  sudo ln -s file symlink
  sudo ln symlink hardlink
  ls -la
  

  Si el comando ln symlink hardlink se completa correctamente, se admite el sistema de archivos.

•         **Rendimiento:** usa el almacenamiento de alto rendimiento con baja latencia e IOPS elevadas para evitar copias de seguridad y restauraciones lentas.
  

•         **NFS:** evita usar un montaje NFS para el directorio de copia de seguridad (normalmente `/data/backup`), ya que esto puede provocar tiempos de espera y un rendimiento degradado.
  

Configuración del servicio de copia de seguridad

Puedes configurar GitHub Enterprise Server Backup Service a través de Consola de administración.

Configuración del destino de copia de seguridad

Antes de configurar el servicio, debes preparar el volumen de almacenamiento donde se almacenarán las copias de seguridad.

Uso de un nuevo dispositivo de bloque

Si usas un dispositivo de bloque dedicado como destino de copia de seguridad, debes inicializarlo a través de SSH antes de continuar en Consola de administración. Este proceso formateará el dispositivo y borrará todos los datos existentes.

1. Conéctate a la instancia a través de SSH como usuario admin. Consulta Acceder al shell administrativo (SSH).

2. Conecte el dispositivo de bloqueo de copia de seguridad a la instancia.

3. Identifica el nombre del dispositivo mediante lsblk para enumerar los dispositivos de bloque disponibles. Asegúrate de seleccionar el dispositivo correcto para evitar la pérdida de datos.

   lsblk
   

4. Ejecuta el comando de inicialización y reemplaza YOUR_DEVICE_NAME por el nombre de dispositivo real identificado en el paso anterior.

   Advertencia

   Este comando borrará permanentemente todos los datos del dispositivo especificado. Comprueba el nombre del dispositivo y realiza una copia de seguridad de los datos importantes antes de continuar.

   ghe-storage-init-backup /dev/YOUR_DEVICE_NAME
   

   Este comando:

   • Formatea al dispositivo (borra todos los datos).

   • Lo prepara para que lo use el servicio de copia de seguridad.

   • Establece que se monte automáticamente en /data/backup al arranque.

Desconectar un disco de copia de seguridad

En caso de que necesite desconectar el disco de copia de seguridad de GitHub Enterprise Server, siga estos pasos.

1. Enumere los dispositivos de bloqueo y desmonte /data/backup.

   sudo lsblk
   sudo umount /data/backup
   

2. Enumera los volúmenes lógicos y desactiva el volumen lógico.

   sudo lvs
   sudo lvchange -an <backup_VG>/<backup_LV>
   

3. Desasocie el disco mediante la consola o la CLI proporcionadas por el proveedor de nube o el hipervisor.

4. Quite el punto de montaje.

   sudo rmdir /data/backup
   

Reutilización de un disco inicializado anteriormente

Si el dispositivo ya se inicializó mediante ghe-storage-init-backup, puedes reutilizarlo sin volver a formatear:

1. Conéctate a la instancia a través de SSH como usuario admin.

2. Conecta el disco a la instancia.

3. Crea el punto de montaje, si no existe.

   sudo mkdir -p /data/backup
   

4. Habilita e inicia el servicio de montaje.

   sudo systemctl enable ghe-backup-disk.service
   sudo systemctl start ghe-backup-disk.service
   

   Esto montará el dispositivo en /data/backup y garantiza que se monta automáticamente en el futuro.

Configuración de las opciones de copia de seguridad

Una vez montado el destino de copia de seguridad, la página Servicio de copia de seguridad estará disponible en Consola de administración en la sección "Copia de seguridad".

Si vas a migrar desde GitHub Enterprise Server Backup Utilities, puedes transferir la configuración de una de estas dos maneras:

1.        **Configuración manual**: vuelve a crear la configuración directamente en Consola de administración.
   

2.        **Migración de la línea de comandos**: Conéctate a la instancia mediante SSH, copia desde backup-utils el archivo `backup.config` y ejecuta:
   

   ghe-migrate-backup-config /path/to/your/backup.config
   

   Usa la marca --dry-run para obtener una vista previa de los cambios sin aplicarlos.

Programación de copias de seguridad automatizadas

Una vez configurado el servicio, puedes definir una programación de copia de seguridad.

1. En Consola de administración, abre la pestaña "Copias de seguridad" en el menú superior.
2. En la sección "Programación de copia de seguridad", elige una programación predefinida (por ejemplo, Diaria) o escribe una expresión cron personalizada.
3. Haga clic en Guardar para aplicar los cambios.

La primera ejecución será una copia de seguridad completa. Las ejecuciones futuras serán incrementales. Si se inicia un nuevo intento de copia de seguridad mientras se está ejecutando uno anterior, se puede omitir o producir un error. En ese caso, ajusta la programación para evitar superposición.