Skip to main content

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.

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.

Advertencia: No cambie el nombre de host para 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, vea "Personalización de mensajes de usuario para la empresa".

  3. En la instancia de origen, habilita el modo de mantenimiento. Para obtener más información, vea «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 obtener más información, vea «Configuración de copias de seguridad en la instancia».

  5. Restaura la copia de seguridad en la instancia de destino con el nombre de host deseado. Al ejecutar la utilidad ghe-restore, usa la opción -c para sobrescribir la configuración de la instancia de destino. Para obtener más información, vea «Configuración de copias de seguridad en la instancia».

  6. Finaliza la configuración de la instancia de destino. Para obtener más información, vea «Configurar GitHub Enterprise».

  7. En la instancia de destino, habilita el modo de mantenimiento.

  8. De manera opcional, mientras la instancia de destino está en modo de mantenimiento, valida la configuración de la instancia y comprueba que los datos del usuario están intactos. Para obtener más información, vea «Habilitar y programar el modo de mantenimiento».

  9. 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.

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