Problemas conocidos con las copias de seguridad de la instancia

Acerca de los problemas conocidos con las copias de seguridad de GitHub Enterprise Server

GitHub proporciona soluciones alternativas para los siguientes problemas que podrían afectar a la copia de seguridad o restauración de datos para una instancia de GitHub Enterprise Server. Para obtener más información, consulta las Notas de la versión de GitHub Enterprise Server.

Los usuarios no pueden iniciar sesión después de la restauración de una copia de seguridad

Si usaste GitHub Enterprise Server Backup Utilities 3.7.0 o 3.8.0 para realizar una copia de seguridad de una instancia que ejecuta cualquier versión en la serie GitHub Enterprise Server 3.7 o 3.8, después de restaurar la copia de seguridad en una nueva instancia, los usuarios no pueden iniciar sesión. Aunque los usuarios no pueden iniciar sesión, la propia copia de seguridad no resulta afectada y todos los datos están intactos.

Después de restaurar una copia de seguridad existente afectada por este problema, puedes resolverlo modificando la configuración en la nueva instancia.

Restauración a partir de una copia de seguridad existente

Si has restaurado una copia de seguridad existente a partir de GitHub Enterprise Server Backup Utilities 3.8.0 en una nueva instancia y los usuarios no pueden iniciar sesión, debes generar datos de configuración de la instancia de origen GitHub Enterprise Server y ajustar la configuración en la instancia de destino.

Para asegurarte de que los usuarios pueden iniciar sesión en la nueva instancia de destino, asegúrate de que el entorno cumpla los siguientes requisitos.

• La instancia de origen GitHub Enterprise Server debe estar en ejecución y ser accesible a través de SSH.
• Debes tener una copia de seguridad existente de GitHub Enterprise Server Backup Utilities 3.7.0 o 3.8.0.
• Debes haber aprovisionado una nueva instancia de destino de GitHub Enterprise Server y restaurado la copia de seguridad. Para obtener más información, vea «Configurar una instancia del servidor de GitHub Enterprise» y «Configuración de copias de seguridad en la instancia».

1. SSH en la instancia de GitHub Enterprise Server de origen de la que has hecho una copia de seguridad. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplaza HOSTNAME por el nombre de host real de la instancia. Para más información sobre el acceso SSH, consulta "Acceder al shell administrativo (SSH)".

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Para mostrar una lista de claves de descifrado, ejecuta el siguiente comando.

   Shell

   ghe-config secrets.github.encrypted-column-keying-material
   

3. Copia la salida en una ubicación segura y temporal.

4. Para mostrar una lista de claves de cifrado, ejecuta el siguiente comando.

   Shell

   ghe-config secrets.github.encrypted-column-current-encryption-key
   

5. Copia la salida en una ubicación segura y temporal.

6. SSH en la instancia de GitHub Enterprise Server de destino donde restauró la copia de seguridad. Reemplaza HOSTNAME por el nombre de host real de la instancia.

   Shell

   ssh -p 122 admin@HOSTNAME
   

7. Habilita el modo de mantenimiento. Para obtener más información, consulta "Habilitar y programar el modo de mantenimiento".

8. Para comprobar que la instancia de destino está lista para la configuración, ejecuta el siguiente comandos. No debería aparecer ninguna salida.

   Shell

   ghe-config secrets.github.encrypted-column-keying-material
   ghe-config secrets.github.encrypted-column-current-encryption-key
   

9. Para actualizar las claves de descifrado en la instancia de destino, ejecuta el siguiente comando. Reemplaza DECRYPTION-KEY-LIST por la salida del paso 1.

   Shell

   ghe-config secrets.github.encrypted-column-keying-material "DECRYPTION-KEY-LIST"
   

10. Para actualizar la clave de cifrado en la instancia de destino, ejecuta el siguiente comando. Reemplaza ENCRYPTION-KEY por la salida del paso 4.

    Shell

    ghe-config secrets.github.encrypted-column-current-encryption-key "ENCRYPTION-KEY"
    

11. Para aplicar la configuración, ejecuta el siguiente comando.

    Shell

    ghe-config-apply
    

12. Espera que se complete la fase de configuración.

13. Para asegurarte de que la configuración de la instancia de destino contiene las claves, ejecuta el siguiente comandos y comprueba que la salida coincide con el paso 1 y el paso 4.

    Shell

    ghe-config secrets.github.encrypted-column-keying-material
    ghe-config secrets.github.encrypted-column-current-encryption-key
    

14. Haz que un usuario inicie sesión en la instancia de destino. Si surgen problemas, ponte en contacto con Soporte técnico para GitHub Enterprise. Para obtener más información, vea «Contactar al Soporte de GitHub».