Skip to main content
Skip to content

Configuración del servicio de copia de seguridad

Habilite y configure el servicio de copia de seguridad integrado en Consola de administracióny, opcionalmente, migre la configuración heredada.

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

  • Instancia GitHub Enterprise Server que ejecuta 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 de datos del dispositivo principal GitHub . 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 duros para un almacenamiento eficaz y la GitHub instancia 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

Puede 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 usa un dispositivo de bloque dedicado como destino de copia de seguridad, debe inicializarlo mediante 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. Consulte Acceder al shell administrativo (SSH).

  2. Adjunta el dispositivo de bloque 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.
    • Configura el montaje automático en /data/backup al arrancar.
    • Si se encuentra en un entorno de clúster, configure el nodo en cluster.conf con el rol backup-server.

Aumentar el tamaño de partición de datos

  1. Redimensione el volumen de disco de copia de seguridad existente montado en /data/backup mediante las herramientas de la plataforma de virtualización.

  2. Conéctese mediante SSH como usuario admin al nodo donde se monta el disco de copia de seguridad. Consulte Acceder al shell administrativo (SSH).

  3. Pon el aparato en modo mantenimiento. Para obtener más información, vea Habilitar y programar el modo de mantenimiento.

  4. Reinicie el dispositivo para detectar la nueva asignación de almacenamiento:

    sudo reboot
    
  5. Ejecute el comando ghe-backup-disk-extend para expandir el sistema de archivos /data/backup:

    ghe-backup-disk-extend
    
  6. Asegúrate de que los servicios de sistema estén funcionando correctamente y luego sal del modo de mantenimiento. Para obtener más información, vea Habilitar y programar el modo de mantenimiento.

Advertencia

Si el ghe-backup-disk-extend comando (o una comprobación automática anterior) notifica: ghe_backup_data contains a file system with errors, debe reparar el sistema de archivos antes de reintentar el cambio de tamaño. No vuelva a ejecutarse ghe-backup-disk-extend hasta que la comprobación se complete limpiamente. Para obtener instrucciones de recuperación, consulte a continuación.

Reparación de errores del sistema de archivos

Si se produce un error en la comprobación del sistema de archivos durante ghe-backup-disk-extend, siga estos pasos para repararlo.

  1. Asegúrese de que el dispositivo está en modo de mantenimiento y que no se están ejecutando trabajos en segundo plano:

    Shell
    ghe-maintenance -s
    ghe-resque-info
    
  2. Detenga y active el volumen de usuario y, a continuación, ejecute una comprobación forzada del sistema de archivos (respuesta automática sí):

    Shell
    sudo systemctl stop ghe-backup-disk
    VGNAME=$(sudo lvs --noheadings -o vg_name | grep ghe_backup_ | awk '{ print $1 }')
    sudo vgchange -ay "$VGNAME"
    sudo vgscan --mknodes
    sudo fsck -fy /dev/mapper/${VGNAME}-ghe_backup_data
    
  3. Vuelva a intentar el cambio de tamaño:

    Shell
    ghe-backup-disk-extend
    
  4. Vuelva a montar y compruebe el nuevo tamaño:

    Shell
    sudo systemctl start ghe-backup-disk
    df -h /data/backup
    
  5. Reinicie y compruebe el nuevo tamaño.

  6. Una vez que el dispositivo se reinicie, vuelva a conectarse mediante SSH al nodo en el que está montado el disco de copia de seguridad y, a continuación, compruebe el nuevo tamaño:

    Shell
    df -h /data/backup
    

Desconectar un disco de copia de seguridad

Advertencia

Antes de desasociar un disco de copia de seguridad, asegúrese de que actualmente no haya copias de seguridad ni restauraciones en curso. Desasociar un disco mientras está en uso puede provocar la pérdida de datos o la interrupción del servicio.

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

  1. Enumerar los dispositivos de bloqueo y desmontar /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.

  5. Si usa un clúster o una configuración de alta disponibilidad (HA), establezca el rol backup-server para el nodo en el que se monta el disco y aplique la configuración.

    Esto también es necesario cuando se agrega una réplica a una instancia independiente que ya usa el servicio de copia de seguridad, incluso si el disco permanece montado. Mantenga el disco inicializado y no vuelva a ejecutar ghe-storage-init-backup. Solo un nodo puede tener el backup-server rol .

    Reemplace HOSTNAME por el nombre de host del nodo en el que se monta el disco, como se muestra en cluster.conf.

    ghe-config cluster.HOSTNAME.backup-server true
    ghe-config-apply
    

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 la Consola de administración sección "Copia de seguridad". Si la instancia forma parte de un entorno en clúster, la página del Servicio de copia de seguridad estará disponible después de ghe-config-apply.

Nota:

La página de configuración no aparecerá hasta que se monte el almacenamiento de copia de seguridad mediante la /data/backup completando los pasos de inicialización o montaje anteriores.

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

  1. Configuración manual: vuelva a crear sus ajustes directamente en el 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.

Realizar una copia de seguridad

Una vez configurado el servicio, puede realizar una copia de seguridad manualmente mediante los pasos siguientes:

  1. En Consola de administración, abra la pestaña "Copias de seguridad" del menú superior.
  2. Haga clic en Hacer copia de seguridad ahora.

Se realizará una GitHub Enterprise Server copia de seguridad y se mostrará en una lista.

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, abra la pestaña «Configuración» desde el menú superior.
  2. En la sección "Copia de seguridad", elija una programación predefinida (por ejemplo, Diaria) o escriba una expresión cron personalizada.
  3. Haga clic en Guardar configuración 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.

Uso de instantáneas de Elasticsearch para datos de índice de búsqueda

De forma predeterminada, se realiza una copia de seguridad de los datos de índice de búsqueda copiando archivos directamente desde el disco. Opcionalmente, puede configurar tu instancia de GitHub Enterprise Server para usar la funcionalidad de instantánea incremental nativa de Elasticsearch con un proveedor de almacenamiento en la nube administrado por el cliente. Para obtener más información, vea Configuración de instantáneas de Elasticsearch.