Requisitos de actualización

Recomendaciones

• Incluye tantas nuevas actualizaciones como sea posible en tu proceso de actualización. Por ejemplo, en lugar de actualizar desde GitHub Enterprise 2.16 a 2.17 a 2.18, podrías actualizar desde GitHub Enterprise 2.16 a 2.18.
• Si estás varias versiones desactualizado, actualiza tu instancia de servidor de GitHub Enterprise tanto como sea posible con cada paso de tu proceso de actualización. Utilizar la versión más reciente posible en cada actualización te permite aprovechar las mejoras de desempeño y las correcciones de errores. Por ejemplo, podrías actualizar desde GitHub Enterprise 2.7 a 2.8 a 2.10, pero actualizar desde GitHub Enterprise 2.7 a 2.9 a 2.10 utiliza una versión posterior en el segundo paso.
• Utiliza el lanzamiento de patch más reciente cuando actualices. Browse to the Servidor de GitHub Enterprise Releases page. Next to the release you are upgrading to, click Download, then click the Upgrading tab.
• Utiliza una instancia de preparación para probar los pasos de actualización. Para obtener más información, consulta "Configurar una instancia de preparación."
• Cuando ejecutes múltiples actualizaciones, espera por lo menos 24 horas entre las actualizaciones de características para permitir que las tareas de actualización de migraciones de datos y de datos en copias de seguridad se completen en su totalidad.

Requisitos

• Debes actualizar desde una característica de lanzamiento que sea como máximo dos lanzamientos anteriores. Por ejemplo, para actualizar a GitHub Enterprise 2.18, debes estar en GitHub Enterprise 2.17 o 2.16.

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

• Es posible que un hotpatch requiera tiempo de inactividad si los servicios afectados (como kernel, MySQL, o Elasticsearch) requieren un reinicio de VM o un reinicio del servicio. Se te notificará cuando se necesite reiniciar. Puedes completar el reinicio más tarde.

• Es necesario que haya un almacenamiento raíz adicional disponible cuando se actualiza a través de un hotpatch, ya que instala múltiples versiones de determinados servicios hasta que se completa la actualización. El control de prevuelo te notificará si no tienes suficiente almacenamiento de disco raíz.

• Cuando se actualiza a través de un hotpatch, tu instancia no puede estar muy cargada, ya que puede impactar el proceso del hotpatch. Los controles de prevuelo considerarán la carga promedio y la actualización fallará si la carga promedio es muy alta.

• Actualizar a Servidor de GitHub Enterprise 2.17 migra tus registros de auditoría desde Elasticsearch a MySQL. Esta migración también incrementa la cantidad de tiempo y el espacio en disco que lleva restaurar una instantánea. Antes de migrar, controla el número de bytes en tus índices de registro de auditoría de ElasticSearch con este comando:

  curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes

  Utiliza el número para estimar la cantidad de espacio de disco que los registros de auditoría de MySQL necesitarán. El script también controla tu espacio libre en disco mientras la importación está en progreso. Controlar este número es especialmente útil si tu espacio libre en disco está cerca de la cantidad de espacio en disco necesaria para la migración.

Después de revisar estas recomendaciones y requisitos, puedes actualizar el Servidor de GitHub Enterprise. Para obtener más información, consulta "Actualizar Servidor de GitHub Enterprise."