Esta versión de GitHub Enterprise Server se discontinuó el 2024-09-25. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Cambiar el nombre de host de la instancia

Si deseas cambiar el nombre de host de una instancia de GitHub Enterprise Server existente, debes restaurar la configuración y los datos en una nueva instancia.

En este artículo

Acerca de los cambios en el nombre de host de GitHub Enterprise Server

Si necesitas usar un nuevo nombre de host para tu instancia de GitHub Enterprise Server, debes realizar una copia de seguridad de la configuración y los datos de la instancia existente, configurar una nueva instancia, restaurar la copia de seguridad en la nueva instancia y, a continuación, ajustar la configuración de DNS para enviar el tráfico a la nueva instancia.

La migración a una nueva instancia requiere tiempo de inactividad. La cantidad de tiempo de inactividad necesario depende de la cantidad de datos que necesitas para realizar copias de seguridad, así como de la velocidad de la conexión de red entre el host de copia de seguridad y las instancias.

En este artículo, el término «instancia de origen» hace referencia a la instancia con el nombre de host antiguo e «instancia de destino» hace referencia a la instancia con el nuevo nombre de host.

Warning

No cambies el nombre de host de GitHub Enterprise Server después de la configuración inicial. Cambiar el nombre del host ocasionará un comportamiento inesperado que puede incluir, llegar hasta la interrupción del servicio y a la invalidación de las claves de seguridad de los usuarios. Si ha cambiado el nombre de host de la instancia y tiene problemas, póngase en contacto con Soporte técnico para GitHub Enterprise o Soporte prémium de GitHub.

Migración a una instancia con un nuevo nombre de host

  1. Configura una instancia de destino de GitHub Enterprise Server con el nuevo nombre de host que desees usar. Para más información, consulte la siguiente documentación.

  2. Informa a los usuarios de la instancia del tiempo de inactividad programado. De manera opcional, puede crear un mensaje obligatorio que le aparecerá a todos los usuarios que inicien sesión. Para más información, consulta Personalización de mensajes de usuario para la empresa.

  3. En la instancia de origen, habilita el modo de mantenimiento para evitar que se produzcan diferencias. Para más información, consulta Habilitar y programar el modo de mantenimiento.

  4. Realiza una copia de seguridad de los datos y la configuración de la instancia de origen mediante GitHub Enterprise Server Backup Utilities. Para más información, consulta Configuración de copias de seguridad en la instancia. (Este paso puede tardar hasta varias horas en completarse).

  5. Si la instancia de origen tiene GitHub Actions habilitado, primero debes configurar el proveedor de almacenamiento externo de GitHub Actions en la instancia de destino. Consulta Respaldar y restablecer GitHub Enterprise Server con GitHub Actions habilitadas.

  6. En la instancia de destino, habilita el modo de mantenimiento para permitir la restauración de la copia de seguridad tomada de la instancia de origen.

  7. Restaura la copia de seguridad en la instancia de destino con el nombre de host deseado. Ejecuta la utilidad ghe-restore sin la opción -c para evitar sobrescribir la configuración de la instancia de destino. Consulta Configuración de copias de seguridad en la instancia.

  8. Finaliza la configuración de la instancia de destino. Para más información, consulta Configurar GitHub Enterprise.

  9. De manera opcional, mientras la instancia de destino está en modo de mantenimiento, valida la configuración de la instancia y el registro de ejecución de configuración (/data/user/common/ghe-config.log) y comprueba que los datos del usuario están intactos. Para más información, consulta Habilitar y programar el modo de mantenimiento.

  10. Para dirigir el tráfico a la instancia de destino, actualiza el registro DNS CNAME con el nombre de host de la instancia de origen para resolver en la dirección IP de la instancia de destino.

    Note

    Es probable que el contenido generado por el usuario restaurado en la aplicación web de la instancia contenga direcciones URL que hagan referencia al nombre de host anterior de la instancia de origen. De manera opcional, para asegurarse de que estos vínculos continúan resolviéndose en la instancia de destino, puede configurar una redirección mediante DNS. Además del registro CNAME que se resuelve en el nombre de host de la nueva instancia, configura un segundo registro DNS CNAME que dirija el tráfico desde el nombre de host original al nuevo nombre de host. Para obtener más información, consulta la documentación de tu proveedor de DNS.

  11. En la instancia de destino, deshabilita el modo de mantenimiento.