Actualizar el servidor de GitHub Enterprise

En este artículo

• Preparar para una actualización
• Tomar una instantánea
• Actualizar con un hotpatch
• Actualizar con un paquete de actualización
• Restaurar desde una actualización fallida

Preparar para una actualización

1. Determina una estrategia de actualización y elige una versión a la que actualizar. Para obtener más información, consulta "Requisitos de actualización."

2. Crea una copia de seguridad nueva de tu instancia principal con las Utilidades de respaldo del servidor de GitHub Enterprise. Para obtener más información, consulta el archivo README.md en Utilidades de respaldo del servidor de GitHub Enterprise.

3. Si estás actualizando con un paquete de actualización, programa una ventana de mantenimiento para los usuarios finales del Servidor de GitHub Enterprise. Si estás usando un hotpatch, no se necesita el modo mantenimiento.

   Nota: la ventana de mantenimiento depende del tipo de actualización que realices. Las actualizaciones que utilizan un hotpatch por lo general no necesitan una ventana de mantenimiento. A veces se necesita reiniciar; puedes hacerlo más tarde. Siguiendo el esquema de control de versiones de MAJOR.FEATURE.PATCH, los lanzamientos de patch que utilizan un paquete de actualización normalmente necesitan menos de cinco minutos de tiempo de inactividad. Los lanzamientos de funciones que incluyen migraciones de datos toman más tiempo dependiendo del desempeño del almacenamiento y de la cantidad de datos que se migran. Para obtener más información, consulta Habilitar y programar el modo mantenimiento."

Tomar una instantánea

Una instantánea es un punto de verificación de una máquina virtual (VM) en un momento en el tiempo. Recomendamos firmemente tomar una instantánea antes de actualizar tu máquina virtual para que si falla una actualización, puedas revertir tu VM nuevamente a la instantánea. Si no estás actualizando a un nuevo lanzamiento de característica, debes tomar una instantánea de VM. Si estás actualizando a un nuevo lanzamiento de patch, puedes adjuntar el disco de datos existente.

Hay dos tipos de instantáneas:

• Las instantáneas de VM guardan el estado completo de tu VM, incluidos los datos del usuario y los datos de configuración. Este método de instantáneas requiere una gran cantidad de espacio de disco e insume mucho tiempo.

• Las instantáneas de disco de datos únicamente guardan tus datos de usuario.

  Notas:

  • Algunas plataformas no permiten que tomes una instantánea solo de tu disco de datos. Para estas plataformas, necesitarás tomar una instantánea de tu VM completa.
  • Si tu hipervisor no admite instantáneas de VM completas, debes tomar una instantánea de tu disco raíz y de tu disco de datos en rápida sucesión.

Actualizar con un hotpatch

You can upgrade Servidor de GitHub Enterprise to the latest patch release using a hotpatch, which does not require a maintenance window and usually does not require a reboot. You can use hotpatching to upgrade to a newer patch release, but not a feature release. For example, you can upgrade from 2.10.1 to 2.10.5 because they are in the same feature series, but not from 2.10.9 to 2.11.0 because they are in a different feature series. Utilizando la Consola de administración, puedes instalar un hotpatch de forma inmediata o programar la instalación para más tarde. Puedes utilizar el shell administrativo para instalar un hotpatch con la herramienta ghe-upgrade. Para obtener más información, consulta "Requisitos de actualización."

Actualizar un aparato único con un hotpatch

Instalar un hotpatch utilizando la Consola de administración

1. Habilitar actualizaciones automáticas. Para obtener más información, consulta "Habilitar actualizaciones automáticas."

2. In the upper-right corner of any page, click .

   

3. En la barra lateral izquierda, haz clic en Consola de administración.

   

4. At the top of the Consola de administración, click Updates.

   

5. Cuando se ha descargado un nuevo hotpatch, utiliza el menú desplegable del paquete de instalación:

   • Para instalar de forma inmediata, selecciona Now (Ahora):
   • Para instalarlo más tarde, selecciona una fecha posterior.
     

6. Haz clic en Install (Instalar).

   

Instalar un hotpatch utilizando un shell administrativo

1. SSH into tu instancia de servidor de GitHub Enterprise.

   $ ssh -p 122 admin@HOSTNAME

2. Visita la Servidor de GitHub Enterprise Página de lanzamientos. Junto a la versión a la que vas a actualizar, haz clic en Download (Descargar), luego haz clic en la pestaña Upgrading (Actualización). Copia el URL para obtener el paquete de actualización (.hpkg file).

3. Descarga el paquete de actualizaciones a tu instancia de servidor de GitHub Enterprise con curl:

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

4. Ejecuta el comando ghe-upgrade utilizando el nombre del archivo del paquete:

   admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg
   *** verificando firma de paquete de actualización...

5. Si se requiere un reinicio para las actualizaciones de kernel, MySQL, Elasticsearch u otros programas, el script de actualización de hotpatch te avisa.

Actualizar un aparato que tiene instancias de réplica utilizando un hotpatch

Los aparatos configurados para alta disponibilidad y de replicación geográfica utilizan instancias de réplica además de las instancias principales. Para actualizar estos aparatos, necesitarás actualizar tanto la instancia principal y todas las instancias de réplica, una a la vez.

Actualizar la instancia principal

1. Actualiza la instancia principal siguiendo las instrucciones en "Instalar un hotpatch utilizando el shell administrativo."

Actualizar una instancia de réplica

1. Actualiza la instancia de réplica siguiendo las instrucciones en "Instalar un hotpatch utilizando el shell administrativo." Si estás usando múltiples réplicas para la replicación geográfica, debes repetir este procedimiento para actualizar cada réplica, una a la vez.

2. Connect to the replica instance over SSH as the "admin" user on port 122:

   $ ssh -p 122 admin@replica-host

3. Verify the upgrade by running:

   $ ghe-version

Actualizar con un paquete de actualización

Al mismo tiempo que puedes utilizar un hotpatch para actualizar al lanzamiento de patch más reciente dentro de una serie de características, debes utilizar un paquete de actualización para actualizar a un lanzamiento de característica más nuevo. Por ejemplo para actualizar de 2.11.10 a 2.12.4 debes utilizar un paquete de actualización ya que están en series de características diferentes. Para obtener más información, consulta "Requisitos de actualización."

Actualizar un aparato único con un paquete de actualización

1. SSH into tu instancia de servidor de GitHub Enterprise.

   $ ssh -p 122 admin@HOSTNAME

2. Visita la Servidor de GitHub Enterprise Página de lanzamientos. Junto a la versión a la que vas a actualizar, haz clic en Download (Descargar), luego haz clic en la pestaña Upgrading (Actualización). Selecciona la plataforma adecuada y copia el URL para obtener el paquete de actualización (.pkg file).

3. Descarga el paquete de actualizaciones a tu instancia de servidor de GitHub Enterprise con curl:

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

4. Habilita el modo mantenimiento y espera que se completen todos los procesos activos en la instancia del Servidor de GitHub Enterprise. Para obtener más información, consulta "Habilitar y programar el modo mantenimiento."

   Nota: cuando se actualiza el aparato primario en una configuración de alta disponibilidad, el aparato debería estar ya en modo mantenimiento si estás siguiendo las instrucciones en "Actualizar la instancia primaria."

5. Ejecuta el comando ghe-upgrade utilizando el nombre del archivo del paquete:

   admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg
   *** verificando firma de paquete de actualización...

6. Confirma que te gustaría continuar con la actualización y reinicia después de que se verifique la firma del paquete. El nuevo sistema de archivos raíz escribe en la segunda partición y la instancia de forma automática se reinicia en modo mantenimiento:

   *** aplicando actualización...
   Este paquete actualizará tu instalación a la versión version-number
   Partición raíz actual: /dev/xvda1 [version-number]
   Partición raíz destino:  /dev/xvda2
   ¿Continuar con la instalación? [s/N]

7. Para las actualizaciones de aparato único, deshabilita el modo mantenimiento para que los usuarios puedan utilizar tu instancia de servidor de GitHub Enterprise.

   Nota: cuando se actualizan aparatos en configuración de alta disponibilidad, deberías mantener el modo mantenimiento hasta que hayas actualizado todas las réplicas y la replicación esté en curso. Para obtener más información, consulta "Actualizar una instancia de réplica."

Actualizar un aparato que tiene instancias de réplica utilizando un paquete de actualización

Los aparatos configurados para alta disponibilidad y de replicación geográfica utilizan instancias de réplica además de las instancias principales. Para actualizar estos aparatos, necesitarás actualizar tanto la instancia principal y todas las instancias de réplica, una a la vez.

Actualizar la instancia principal

1. En la instancia primaria, habilita el modo mantenimiento y espera a que se completen todos los procesos activos. Para obtener más información, consulta "Habilitar el modo mantenimiento."

2. Connect to the replica instance over SSH as the "admin" user on port 122:

   $ ssh -p 122 admin@replica-host

3. En la instancia de réplica, o en todas las instancias de réplica si estás ejecutando múltiples instancias de réplica como parte de una replicación geográfica, ejecuta ghe-repl-stop para detener la replicación.

4. Actualiza la instancia primaria siguiendo las instrucciones en "Actualizar un aparato único con un paquete de actualización."

Actualizar una instancia de réplica

1. Actualiza la instancia de réplica siguiendo las instrucciones en "Actualizar un aparato único con un paquete de actualización." Si estás usando múltiples réplicas para la replicación geográfica, debes repetir este procedimiento para actualizar cada réplica, una a la vez.

2. Connect to the replica instance over SSH as the "admin" user on port 122:

   $ ssh -p 122 admin@replica-host

3. Verify the upgrade by running:

   $ ghe-version

4. On the replica instance, to start replication, run ghe-repl-start.

5. On the replica instance, to make sure replication services are running correctly, run ghe-repl-status. This command will return OK for all services when a successful replication is in progress and the replica has upgraded. Si el comando devuelve La replicación no se está ejecutando, la replicación puede estar comenzando. Espera alrededor de un minuto antes de volver a ejecutar ghe-repl-status.

   Nota: mientras la resincronización está en progreso, ghe-repl-status puede devolver mensajes esperados que indiquen que la replicación está de forma subyacente. Por ejemplo: CRITICO: la replicación de git está de forma subyacente de la primaria por más de 1007 repositorios o gists

   Si ghe-repl-status no devuelve OK, sigue los pasos de abajo para iniciar la replicación de forma manual.

   1. En la instancia de réplica, ejecuta nuevamente ghe-repl-setup <primary-instance-ip>.

   2. On the replica instance, to start replication, run ghe-repl-start.

   3. On the replica instance, to make sure replication services are running correctly, run ghe-repl-status. This command will return OK for all services when a successful replication is in progress and the replica has upgraded.

6. Cuando hayas completado la actualización de la última réplica, y se haya completado la resincronización, deshabilita el modo mantenimiento para que los usuarios puedan utilizar tu instancia de servidor de GitHub Enterprise.

Restaurar desde una actualización fallida

Si una actualización falla o se interrumpe, deberías revertir tu instancia a su estado anterior. El proceso para completar esto depende del tipo de actualización.

Revertir un lanzamiento de patch

Para volver a lanzar una versión de parche, usa el comando ghe-upgrade con el comando --allow-patch-rollback switch. When rolling back an upgrade, you must use an upgrade package file with the .pkg extension. Hotpatch package files with the .hpkg extension are not supported.

ghe-upgrade --allow-patch-rollback EARLIER-RELEASE-UPGRADE-PACKAGE.pkg

Se debe reiniciar después de ejecutar el comando. Rolling back does not affect the data partition, as migrations are not run on patch releases.

Para obtener más información, consulta "Herramientas de línea de comando."

Revertir un lanzamiento de característica

Para revertir un lanzamiento de característica, restaura desde una instantánea de VM para garantizar que las particiones raíz y de datos estén en un estado consistente. Para obtener más información, consulta "Tomar una instantánea."