Actualizar con un hotpatch

Puede actualizar GitHub Enterprise Server a la última versión de parche mediante un parche en caliente.

Puedes usar el hotpatching para actualizar a una versión de revisión más reciente, pero no a una versión con nuevas funcionalidades. Por ejemplo, puedes subir de nivel de 2.10.1 a 2.10.5 porque están en la misma serie de características, pero no de 2.10.9 a 2.11.0, porque están en una serie de características diferente.

Los parches en caliente no siempre requieren un reinicio. Cuando instales el hotpatch, verás un mensaje en el terminal si alguno de los paquetes requiere reiniciar el sistema para completar la actualización. Puede programar este reinicio en un momento que le convenga, pero se recomienda reiniciar tan pronto como sea práctico, especialmente si hay alguna corrección de seguridad.

Los hotpatches requieren una ejecución de configuración, lo que puede provocar un breve período de errores o falta de respuesta para algunos o todos los servicios de tu instancia de GitHub Enterprise Server. No es necesario habilitar el modo de mantenimiento durante la instalación de un parche en caliente, pero hacerlo garantizará que los usuarios vean una página de mantenimiento en lugar de errores o tiempos de espera. Consulta Habilitar y programar el modo de mantenimiento.

Consola de administraciónCon , puede instalar una revisión rápida inmediatamente o programarla para la instalación posterior. Puede usar el shell administrativo para instalar una revisión en caliente con la utilidad ghe-upgrade. Consulta Información general del proceso de actualización y Requisitos de actualización.

Actualización mediante un parche en caliente de una instancia independiente

Si va a actualizar una instancia con un nodo mediante una revisión activa y el destino es una versión de revisión, puede actualizar mediante Consola de administración. Para actualizar a una versión con nuevas funcionalidades, debes usar la consola de administración.

• Instalación de una revisión activa mediante Consola de administración
• Instalación de una revisión en caliente con un shell administrativo

Instalación de una revisión activa mediante Consola de administración

Puede usar Consola de administración para actualizar con una revisión activa habilitando las actualizaciones automáticas. A continuación, se le presentará la versión más reciente disponible de GitHub Enterprise Server a la que puede actualizar.

Si el destino de actualización con el que se presenta es una versión de características en lugar de una versión de revisión, no puede usar Consola de administración para instalar una revisión. En vez de eso, deberás instalar el hotpatch utilizando el shell administrativo.

1. Habilitar las actualizaciones automáticas. Para más información, consulta Habilitar comprobaciones de actualización automáticas.

2. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

3. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

4. En la barra lateral " Site admin", haz clic en Consola de administración.

5. En la barra de navegación superior, haga clic en Actualizaciones

   

6. Cuando se ha descargado un nuevo parche rápido, seleccione el menú desplegable Instalar paquete.

   • Para instalar inmediatamente, haga clic en Ahora.
   • Para instalarlo más tarde, selecciona una fecha posterior.

7. Haga clic en Instalar.

Instalar un hotpatch utilizando un shell de administración

1. SSH en tu instancia de GitHub Enterprise Server. 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. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Vaya a la página de versiones de GitHub Enterprise Server. Junto a la versión a la que va a actualizar, haga clic en Download y después en la pestaña Upgrading. Copie la dirección URL del hotpackage de actualización (archivo .hpkg ).

3. Descargue el paquete de actualización a tu instancia de GitHub Enterprise Server mediante curl:

   admin@HOSTNAME:~$ curl -L -O UPGRADE-PKG-URL
   

4. Ejecute el comando ghe-upgrade con el nombre del archivo de paquete:

   admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg
   *** verifying upgrade package signature...
   

5. Si al menos un servicio o componente del sistema requiere un reinicio, el script de actualización de hotpatch se lo notifica. Por ejemplo, las actualizaciones del kernel, MySQL o Elasticsearch pueden requerir un reinicio.

Actualización de una instancia con varios nodos mediante un hotpatch

Si va a instalar una revisión en caliente, no es necesario entrar en modo de mantenimiento ni detener la replicación.

• Actualización del nodo principal con una revisión en caliente
• Actualización de nodos adicionales utilizando un hotpatch

Actualización del nodo principal mediante un parche en caliente

Para instrucciones sobre cómo actualizar el nodo principal, consulta Instalación de un hotpatch mediante el shell administrativo.

Actualización de nodos adicionales mediante un parche en caliente

Para actualizar una instancia que consta de varios nodos, como una configuración de alta disponibilidad o replicación geográfica, debe repetir el procedimiento siguiente en cada nodo de réplica, de uno en uno.

1. Para actualizar el nodo, sigue las instrucciones de Instalación de un parche en caliente mediante el administrador de comandos.

2. Conéctese al nodo de réplica a través de SSH como el usuario admin en el puerto 122:

   ssh -p 122 admin@REPLICA_HOST
   

3. Verifica la mejora ejecutando:

   ghe-version
   

4. Repita los pasos anteriores para cada nodo adicional.