Skip to main content

Requisitos de actualización

Antes de actualizar el GitHub Enterprise Server, revisa estas recomendaciones y requisitos para planificar tu estrategia de actualización.

Notas:

  • Los paquetes de actualización están disponibles en enterprise.github.com para las versiones compatibles. Verifica la disponibilidad de los paquetes de actualización, deberás completar la actualización. Si un paquete no está disponible, contacta a Soporte de GitHub Enterprise para obtener ayuda.
  • Si usa agrupación en clústeres de GitHub Enterprise Server, vea "Actualización de un clúster" en la Guía de agrupación en clústeres de GitHub Enterprise Server a fin de obtener instrucciones específicas exclusivas para la agrupación en clústeres.
  • Estas notas de lanzamiento para el GitHub Enterprise Server brindan una lista detallada de las nuevas características de cada versión del GitHub Enterprise Server. Para más información, vea la página de versiones.

Recomendaciones

  • Incluye tantas nuevas actualizaciones como sea posible en tu proceso de actualización. Por ejemplo, en lugar de actualizar desde GitHub Enterprise 3.5 a 3.6 a 3.7, podrías actualizar desde GitHub Enterprise 3.5 a 3.7. Use el Asistente de mejora para buscar la ruta de actualización de la versión actual.
  • Si estás varias versiones por detrás, actualiza your GitHub Enterprise Server instance tanto como sea posible con cada paso del 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. 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.
  • Utiliza una instancia de preparación para probar los pasos de actualización. Para más información, vea "Configuración de una instancia de almacenamiento provisional".
  • Cuando ejecutas varias mejoras, espera por lo menos 24 horas entre las mejoras a las características para permitir que se completen totalmente las migraciones de datos y actualizaciones de las tareas que se ejecutan en segundo plano.
  • Toma una captura de pantalla antes de que mejores tu máquina virtual. Para más información, vea "Realización de una instantánea".
  • Asegúrate de que tienes un respaldo reciente y exitoso de tu instancia. Para más información, vea Archivo README.md de GitHub Enterprise Server Backup Utilities.

Requisitos

  • Debe actualizar desde una versión de actualización de características que esté como máximo dos versiones por detrás. Por ejemplo, para actualizar a GitHub Enterprise 3.7, debes estar en GitHub Enterprise 3.6 o 3.5.
  • Cuando hagas una mejora mediante un paquete de mejora, programa una ventana de mantenimiento para los usuarios finales de GitHub Enterprise Server.
  • You can upgrade GitHub Enterprise Server to the latest patch release using a hotpatch.

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.

Hotpatches do not generally require a reboot. If a hotpatch does require a reboot, the GitHub Enterprise Server release notes will indicate the requirement.

Hotpatches require a configuration run, which can cause a brief period of errors or unresponsiveness for some or all services on your GitHub Enterprise Server instance. You are not required to enable maintenance mode during installation of a hotpatch, but doing so will guarantee that users see a maintenance page instead of errors or timeouts. For more information, see "Enabling and scheduling maintenance mode."

  • 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.
  • Actualizar a GitHub Enterprise Server 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.

Pasos siguientes

Después de revisar estas recomendaciones y requisitos, puedes actualizar el GitHub Enterprise Server. Para más información, vea "Actualización de GitHub Enterprise Server".