Actualizar con un hotpatch

Puedes actualizar GitHub Enterprise Server a la versión de revisión más reciente mediante una revisión en caliente.

Puedes utilizar los hotpatches para subir de categoría a un nuevo lanzamiento parchado, pero no a un lanzamiento de características. 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.

Las revisiones en caliente no siempre requieren un reinicio. Al instalar la revisión en caliente, verá un mensaje en el terminal si alguno de los paquetes necesita reiniciarse 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.

Las revisiones en caliente requieren una ejecución de configuración, lo que puede provocar un breve período de errores o falta de respuesta en algunos servicios de tu instancia de GitHub Enterprise Server o en todos ellos. No es necesario habilitar el modo de mantenimiento durante la instalación de una revisión en caliente, pero si lo hace, se garantiza que los usuarios vean una página de mantenimiento en lugar de errores o tiempos de espera. Consulte "Habilitar y programar el modo de mantenimiento".

Si utilizas la Consola de administración, puedes instalar un hotpatch de inmediato o programarlo para que se instale posteriormente. 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 de una instancia independiente mediante una revisión en caliente

Si va a actualizar una instancia con un nodo utilizando una revisión en caliente y el destino es una versión de revisión, puede actualizar utilizando Consola de administración. Para actualizar a una versión de características, debes usar el shell administrativo.

• Instalar un hotpatch utilizando la Consola de administración
• Instalar un hotpatch utilizando un shell administrativo

Instalar un hotpatch utilizando la Consola de administración

Puedes utilziar la Consola de administración para hacer una mejora con un hotpatch si habilitas las actualizaciones automáticas. Entonces se te presentará la última versión disponible de GitHub Enterprise Server a la cual puedes mejorar.

Si el objetivo de actualización que se te presentó es un lanzamiento de una característica en vez de un lanzamiento de parche, no podrás utilizar la Consola de administración para instalar un hotpatch. En vez de eso, deberás instalar el hotpatch utilizando el shell administrativo.

1. Habilitar las actualizaciones automáticas. Para obtener más información, vea «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, haga 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 " Administrador del sitio", haz clic en Consola de administración .

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

   

6. Cuando se ha descargado una nueva revisión en caliente, seleccione el menú desplegable del Paquete de instalación.

   • 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 administrativo

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 obtener más información, vea «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 URL para obtener el paquete 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 una revisión en caliente

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 mediante una revisión en caliente
• Actualización de nodos adicionales mediante una revisión en caliente

Actualización del nodo principal mediante una revisión en caliente

Para obtener instrucciones para actualizar el nodo principal, consulte "Instalación de una revisión de acceso rápido mediante el shell administrativo".

Actualización de nodos adicionales mediante una revisión 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, siga las instrucciones de "Instalación de una revisión en caliente mediante el shell administrativo".

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.