Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Requisitos de actualización

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

Notas:

  • Para actualizar desde GitHub Enterprise 11.10.348 a 11.10.354, debes primero migrar a GitHub Enterprise 2.1.23. Para obtener más información, consulta "Migrar desde GitHub Enterprise 11.10.x a 2.1.23."
  • Los paquetes de actualización están disponibles en enterprise.github.com para las versiones admitidas. Verifica la disponibilidad de los paquetes de actualización, deberás completar la actualización. Si un paquete no está disponible, contacta a GitHub Enterprise Support](https://enterprise.githubsupport.com/hc/en-us) o GitHub Premium Support para obtener ayuda.
  • Si estás usando una Agrupación del GitHub Enterprise Server, consulta "Actualizar una agrupación" en la Guía de Agrupación del GitHub Enterprise Server para obtener instrucciones específicas únicas para agrupaciones.
  • 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 obtener más información, consulta las páginas de lanzamiento.

Recomendaciones

  • Incluye tantas nuevas actualizaciones como sea posible en tu proceso de actualización. Por ejemplo, en lugar de actualizar desde GitHub Enterprise 3.0 a 3.1 a 3.2, podrías actualizar desde GitHub Enterprise 3.0 a 3.2.
  • Si estás varias versiones desactualizado, actualiza tu instancia de GitHub Enterprise Server 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. Visita la GitHub Enterprise Server 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).
  • 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 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.

Requisitos

  • Debes actualizar desde una característica de lanzamiento que sea como máximo dos lanzamientos anteriores. Por ejemplo, para actualizar a GitHub Enterprise 3.2, debes estar en GitHub Enterprise 3.1 o 3.0.
  • Puedes mejorar GitHub Enterprise Server al último lanzamiento parchado utilizando un hotpatch, lo cual no requerirá una ventana de mantenimiento y, habitualmente, no requiere un reinicio. 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 mejorar de 2.10.1 a 2.10.5 porque pertenecen a 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.
  • 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 pre-vuelo considerarán la carga promedio y, posteriormente, la mejora fallará si dicha carga promedio es demasiado alta. - Mejorar a GitHub Enterprise Server 2.17 migrará sus registros de auditoría de Elasicsearch 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.

Acerca de los requisitos mínimos para GitHub Enterprise Server 3.0 y superior

Antes de actualizar a GitHub Enterprise Server 3.0 o superior, revisa los recursos de hardware que has aprovisionado para tu instancia. GitHub Enterprise Server 3.0 presenta características nuevas tales como GitHub Actions y el Registro del paquete de GitHub, y requiere más recursos que la versión 2.22 y anteriores. Para obtener más información, consulta la sección de notas de lanzamiento para GitHub Enterprise Server 3.0.

Los requisitos que incrementan para GitHub Enterprise Server 3.0 y posterior se muestran en negritas en la siguiente tabla.

Licencias de usuariovCPUMemoriaAlmacenamiento conectadoAlmacenamiento raíz
Prueba, Demo o 10 usuarios no frecuentes4
Aumentando desde 2
32 GB
Aumentando desde 16 GB
150 GB
Aumentando desde 100 GB
200 GB
10-30008
Aumentando desde 4
48 GB
Aumentando desde 32 GB
300 GB
Aumentando desde 250 GB
200 GB
3000-500012
Aumentando desde 8
64 GB500 GB200 GB
5000-800016
Aumentando desde 12
96 GB750 GB200 GB
8000-10000+20
Aumentando desde 16
160 GB
Aumentando desde 128 GB
1000 GB200 GB

Para obtener más información acerca de los requisitos de hardware para las GitHub Actions, consulta la sección "Comenzar con las GitHub Actions para GitHub Enterprise Server".

Para obtener más información sobre el ajuste de recursos para una instancia existente, consulta las secciones "Incrementar la capacidad de almacenamiento" e "Incrementar los recursos de memoria o de CPU".

Pasos siguientes

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