Skip to main content
Skip to content

Problemas conocidos con las actualizaciones de la instancia

Consulte información general sobre las soluciones alternativas para problemas que afectan al proceso de actualización de GitHub Enterprise Servero que afectan a la instancia después de completar una actualización.

Acerca de los problemas conocidos con las actualizaciones de GitHub Enterprise Server

GitHub es consciente de los siguientes problemas que podrían afectar a las actualizaciones a las nuevas versiones de GitHub Enterprise Server. Para obtener más información, consulte la sección "Problemas conocidos" en las notas de la GitHub Enterprise Server versión.

Si ve el error The file provided is not a valid GitHub Enterprise Server package al intentar una actualización, es posible que tenga que rotar la clave de firma de GPG en la instancia. Para más información, consulta Rotación de la clave de firma para los paquetes de actualización.

GitHub recomienda encarecidamente copias de seguridad periódicas de la configuración y los datos de la instancia. Antes de continuar con cualquier actualización, realiza una copia de seguridad de la instancia y, a continuación, valida la copia de seguridad en un entorno de ensayo. Para más información, consulta Acerca del servicio de copia de seguridad de GitHub Enterprise Server y Configurar una instancia de preparación.

La coincidencia de SAML NameID distingue mayúsculas de minúsculas

Este cambio se aplica a GitHub Enterprise Server la versión 3.19.16, 3.20.12, 3.21.10 y 3.22.5, publicada el 17 de noviembre de 2026. No se aplica ni a GitHub Enterprise Cloud ni a GitHub Enterprise Server instancias con el aprovisionamiento SCIM habilitado.

Una corrección de seguridad cambia cómo se hacen coincidir los valores de SAML NameID con las cuentas existentes. Las diferencias en mayúsculas, acentos o espacios finales se rechazan en lugar de ignorarse. Esto ayuda a evitar que un inicio de sesión de SAML seleccione la cuenta incorrecta GitHub .

Si el proveedor de identidades (IdP) NameID enviado durante la autenticación SAML no coincide exactamente con la asignación de SAML almacenada del usuario en GitHub Enterprise Server, se produce un error en la autenticación. Por ejemplo, una entrada NameID de Mona ya no coincide con un NameID almacenado de mona. El usuario ve el error. Another user already owns the account. Please have your administrator check the authentication log.

Antes de actualizar, compruebe que los valores SAML NameID enviados por el IdP coinciden exactamente con los valores de asignación NameID de SAML almacenados, incluidas las mismas letras mayúsculas y minúsculas.

  1. Compruebe el SAML NameID almacenado del usuario en la pestaña Seguridad del panel de administración del sitio. Para más información, consulta Actualización de NameID de SAML de un usuario. También puede exportar asignaciones mediante ghe-saml-mapping-csv --dump. Esta utilidad no admite instancias que utilizan el aprovisionamiento SCIM.
  2. Compruebe el SAML NameID entrante para el usuario. Habilite temporalmente la depuración de SAML, reproduzca el intento de inicio de sesión de SAML del usuario e inspeccione las respuestas de NameID SAML en los systemd registros del diario para github-unicorn. Deshabilite la depuración inmediatamente después para evitar un registro excesivo y un posible impacto en el rendimiento. Para más información, consulta Solución de problemas de autenticación SAML.

Si los valores difieren, actualice la asignación de SAML NameID almacenada del usuario para que coincida con el valor enviado por el IdP.

Estamos trabajando para restaurar el comportamiento de coincidencia de SAML NameID que no distingue mayúsculas de minúsculas anterior. Las notas de la versión anunciarán cuándo está disponible esta actualización.

Eliminar la pausa en las actualizaciones a la versión 3.15 y posteriores

Hemos quitado la pausa en las actualizaciones a las versiones 3.15, 3.16 y 3.17. Ahora puedes actualizar a 3.15.12, 3.16.8, 3.17.5 o posterior. No se recomienda actualizar a versiones anteriores de 3.15, 3.16 o 3.17. Como paso adicional, se recomienda comprobar la capacidad del sistema antes de actualizar. Consulta Comprobación de la capacidad del sistema antes de la actualización.

Hemos ampliado la ventana de soporte técnico para las versiones 3.14, 3.15, 3.16 y 3.17. La ventana de soporte técnico para la versión 3.13 permanece sin cambios. Se ha actualizado la fecha de cierre de cada una de las versiones 3.14, 3.15, 3.16 y 3.17. Para más información, consulta Lanzamientos de GitHub Enterprise Server.

Seguiremos lanzando revisiones para 3.14, 3.15, 3.16 y 3.17 en esta ventana de soporte extendido.

El tamaño de disco raíz requerido aumentó a 400 GB.

Nota:

Se ha quitado el requisito anterior de tamaño del disco raíz de 400 GB para las versiones 3.15.2 y posteriores. Este requisito se basaba en el análisis de paquetes de soporte e incidencias de soporte técnico. Algunos factores, como los registros, ejercen una presión excesiva en el disco raíz que provocó problemas del dispositivo. Después de recibir comentarios por parte de muchos clientes de que es difícil adquirir hardware nuevo, se revierte el requisito a favor de un enfoque gradual. Todavía recomendamos que los clientes, especialmente aquellos que usan topologías independientes o topologías autónomas de alta disponibilidad, actualicen el disco raíz a 400 GB. Cuando puedas actualizar el disco raíz a 400 GB, consulta las instrucciones siguientes.

Para los clientes que usan topologías de alta disponibilidad o independientes, se recomienda que las nuevas instalaciones de 3.15 o posteriores, o las actualizaciones a 3.15, utilicen el tamaño del disco raíz de al menos 400 GB. GitHub recomienda encarecidamente seguir las instrucciones de Aumentar la capacidad de almacenamiento.

Registros indescifrables

Si va a actualizar de GitHub Enterprise Server 3.11 o 3.12 a 3.13, o de 3.12 a 3.14, puede encontrarse con un problema con registros sin cifrar debido a que faltan claves necesarias para el descifrado. La única solución es eliminar los registros indescifrables. El tipo de registros afectados por esta incidencia son registros con autenticación en dos fases, lo que significa que es posible que tenga que pedir a los usuarios que vuelvan a habilitar la autenticación en dos fases (2FA).

Antes de actualizar

Si va a actualizar de GitHub Enterprise Server 3.11 o 3.12 a 3.13, o de 3.12 a 3.14, puede ejecutar el script de diagnóstico de cifrado para identificar los registros no descifrables con antelación. Este script no modificará ningún registro, pero te dará la oportunidad de comprender el impacto y planearlo.

  1. Descarga el script de diagnóstico de cifrado. Puedes usar un comando como curl -L -O https://gh.io/ghes-encryption-diagnostics para descargar el script.
  2. Guarda el script en el directorio /data/user/common del dispositivo.
  3. Sigue las instrucciones de la parte superior del script y ejecútalo en el dispositivo. Si hay registros indescifrables, se registran en /tmp/column_encryption_records_to_be_deleted.log. Los registros registrados aquí no se pudieron descifrar porque el sistema no pudo encontrar las claves que se usaron para cifrar los registros.

Ten en cuenta que estos registros se eliminarán como parte del proceso de actualización. El script le advertirá sobre los usuarios que deberán volver a inscribirse en la autenticación en dos fases después de la actualización. Los identificadores de los usuarios afectados se registran en /tmp/column_encryption_users_to_have_2fa_disabled.log. Estos usuarios deberán volver a inscribirse en la autenticación de dos factores.

Si el script tiene problemas inesperados, se le pedirá que se comunique con Soporte de GitHub. Los errores relacionados con estas incidencias se registrarán en /tmp/column_encryption_unexpected_errors.log. Si está en una situación grave y no puede hacer que los usuarios vuelvan a inscribirse en 2FA, póngase en contacto con Soporte de GitHub para obtener ayuda.

El script imprimirá "Éxito: registros cifrados correctamente." si pudo encontrar las claves asociadas a los registros cifrados. Estos registros se descifrarán y conservarán durante el proceso de actualización y no requerirán tu intervención manual.

Durante la actualización

En caso de que no hayas tenido la oportunidad de ejecutar el script de diagnóstico de cifrado con antelación, hay mecanismos en el producto que te ayudarán. Las comprobaciones previas al vuelo durante el proceso de actualización detectarán registros indescifrables y los registrarán en /tmp/column_encryption_records_to_be_deleted.log. La secuencia te advertirá de los usuarios que deberán volver a habilitar la autenticación en dos fases después de la actualización. Los registros de los usuarios afectados se registran en /tmp/column_encryption_users_to_have_2fa_disabled.log.

Si se detectan registros indescifrables, se te pedirá si deseas continuar con la actualización o no. Si continúas, el proceso de actualización elimina los registros indescifrables. De lo contrario, el proceso de actualización se cerrará.

Si tiene alguna pregunta durante la actualización, puede ponerse en contacto con Soporte de GitHub. Una vez que hayas tenido el tiempo y la oportunidad de comprender el impacto, puedes volver a activar la actualización.