О известных проблемах с GitHub Enterprise Server апгрейдами
GitHub осознаёт следующие проблемы, которые могут повлиять на обновления новых релизов GitHub Enterprise Server. Для получения дополнительной информации см. раздел «Известные проблемы» в примечанияхGitHub Enterprise Server к релизу.
Если при попытке апгрейда появляется ошибка The file provided is not a valid GitHub Enterprise Server package, возможно, придётся повернуть ключ подписи GPG на вашем экземпляре. Дополнительные сведения см. в разделе Вращение ключа подписи для пакетов обновления.
GitHub Настоятельно рекомендуется регулярно делать резервные копии конфигурации и данных вашего экземпляра. Прежде чем продолжить обновление, создайте резервную копию экземпляра, а затем проверьте резервную копию в промежуточной среде. Дополнительные сведения см. в разделе [AUTOTITLE и Настройка резервных копий на вашем экземпляре с помощью Backup Utilities](/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance).
Сопоставление SAML NameID учитывает регистр
Это изменение относится к GitHub Enterprise Server версии 3.19.16, 3.20.12, 3.21.10 и 3.22.5, выпущенной 17 ноября 2026 года. Он не применяется к GitHub Enterprise Cloud GitHub Enterprise Server экземплярам с включенной подготовкой SCIM.
Исправление безопасности изменяет соответствие значений SAML NameID существующим учетным записям. Различия в прописи, акцентах или конечных пробелах отклоняются, а не игнорируются. Это помогает предотвратить вход SAML при выборе неправильной GitHub учетной записи.
Если поставщик NameID удостоверений (IdP) во время проверки подлинности SAML точно не соответствует сохраненной сопоставлению GitHub Enterprise ServerSAML пользователя, проверка подлинности завершается ошибкой. Например, входящие NameID Mona больше не соответствуют хранящемуся mona``NameID объекту. Пользователь видит ошибку Another user already owns the account. Please have your administrator check the authentication log.
Перед обновлением убедитесь, что значения SAML, отправленные поставщиком удостоверений, точно соответствуют сохраненным значениям сопоставления NameID SAMLNameID, включая те же прописные и строчные буквы.
- Проверьте сохраненный SAML
NameIDпользователя на вкладке "Безопасность " на панели мониторинга администратора сайта. Дополнительные сведения см. в разделе Обновление SAML NameID пользователя. Можно также экспортировать сопоставления с помощьюghe-saml-mapping-csv --dump. Эта программа не поддерживает экземпляры с помощью подготовки SCIM. - Проверьте входящие SAML
NameIDдля пользователя. Временно включите отладку SAML, воспроизводит попытку входа пользователя SAML и проверьте ответNameIDSAML вsystemdжурналах журналов.github-unicornОтключите отладку сразу после этого, чтобы избежать чрезмерного ведения журнала и потенциального влияния на производительность. Дополнительные сведения см. в разделе Устранение неполадок с проверкой подлинности SAML.
Если значения отличаются, обновите сохраненное сопоставление SAML NameID пользователя, чтобы оно соответствовало значению, отправленное поставщиком удостоверений.
Мы работаем над восстановлением предыдущего нечувствительного поведения сопоставления SAML NameID . Заметки о выпуске будут объявляться, когда это обновление доступно.
Отмена приостановки при обновлении до версии 3.15 и выше
Мы подняли паузу на обновления до версий 3.15, 3.16 и 3.17. Теперь можно обновить до версии 3.15.12, 3.16.8, 3.17.5 или более поздней версии. Мы не рекомендуем обновить до более ранних выпусков версии 3.15, 3.16 или 3.17. В качестве дополнительного шага рекомендуется проверить емкость системы перед обновлением. См . раздел AUTOTITLE.
Мы расширили окно поддержки для версий 3.14, 3.15, 3.16 и 3.17. Окно поддержки 3.13 остается неизменным. Дата закрытия для каждого из 3.14, 3.15, 3.16 и 3.17 обновлена. Дополнительные сведения см. в разделе Релизы GitHub Enterprise Server.
Мы будем продолжать выпускать исправления для 3.14, 3.15, 3.16 и 3.17 в этом расширенном окне поддержки.
Требуемый размер корневого диска увеличился до 400 ГБ
Примечание.
Предыдущее требование к размеру корневого диска 400 ГБ для версий 3.15.2 и более поздних версий было удалено. Это требование было основано на анализе пакетов поддержки и запросов в службу поддержки. Некоторые факторы, такие как журналы, оказывают чрезмерное давление на корневой диск, который вызвал проблемы с устройством. Получив отзыв о том, что это сложно для многих клиентов приобретать новое оборудование, мы откатили требование в пользу постепенного подхода. Мы по-прежнему рекомендуем клиентам, особенно тем, кто использует автономные или автономные топологии высокой доступности, обновите корневой диск до 400 ГБ. Если вы сможете обновить корневой диск до 400 ГБ, ознакомьтесь со следующими инструкциями.
Для клиентов, использующих автономные топологии или топологии высокого уровня доступности, рекомендуется использовать новые установки версии 3.15 или более поздней версии или обновления до версии 3,15, чтобы использовать размер корневого диска не менее 400 ГБ. GitHubНастоятельно рекомендую следовать указаниям в AUTOTITLE.
Нешифрованные записи
Если вы обновляетесь с GitHub Enterprise Server 3.11 или 3.12 до 3.13, или с 3.12 на 3.14, вы можете столкнуться с проблемой с нерасшифрованными записями из-за отсутствия необходимых ключей для расшифровки. Единственным решением является удаление нешифрованных записей. Тип записей, затронутых этой проблемой, — это записи 2FA, что означает, что пользователям может потребоваться повторно включить двухфакторную проверку подлинности (2FA).
Перед обновлением
Если вы обновляетесь с GitHub Enterprise Server 3.11 или 3.12 до 3.13, или с 3.12 до 3.14, можно запустить скрипт диагностики шифрования, чтобы заранее определить нерасшифрованные записи. Этот скрипт не будет изменять записи, но даст вам возможность понять влияние и запланировать его.
- Скачайте скрипт шифрования диагностика. Для скачивания скрипта можно использовать команду
curl -L -O https://gh.io/ghes-encryption-diagnostics. - Сохраните скрипт
/data/user/commonв каталоге на устройстве. - Следуйте инструкциям в верхней части скрипта и выполните его на устройстве. Если есть какие-либо нешифрованные записи, они вошли в
/tmp/column_encryption_records_to_be_deleted.logсистему. Все записи, зарегистрированные здесь, не удалось расшифровать, так как система не смогла найти ключи, которые использовались для шифрования записей.
Обратите внимание, что эти записи будут удалены в процессе обновления. Скрипт предупредит пользователей, которым потребуется повторно зарегистрировать 2FA после обновления. Затронутые дескрипторы пользователей вошли в /tmp/column_encryption_users_to_have_2fa_disabled.logсистему. Эти пользователи должны быть повторно зарегистрированы в 2FA.
Если сценарий столкнётся с неожиданными проблемами, вам будет предложено связаться Служба поддержки GitHubс . Ошибки, связанные с этими проблемами, будут входить в /tmp/column_encryption_unexpected_errors.logсистему. Если вы оказались в критической ситуации и не можете зарегистрировать пользователей в 2FA, обратитесь Служба поддержки GitHub за помощью.
Сценарий будет печатать "Success: Encrypted Records OK". Если он смог найти ключи, связанные с зашифрованными записями. Эти записи будут расшифрованы и сохранены во время процесса обновления и не требуют вмешательства вручную.
Во время обновления
Если у вас нет возможности запустить скрипт шифрования диагностика заранее, существуют механизмы в продукте, которые помогут вам. Предварительные проверки во время обновления будут обнаруживать нешифрованные записи и регистрировать их /tmp/column_encryption_records_to_be_deleted.log. Последовательность предупреждает пользователей, которым потребуется повторно включить 2FA после обновления. Затронутые записи пользователей вошли в /tmp/column_encryption_users_to_have_2fa_disabled.logсистему.
Если обнаружены нешифрованные записи, вам будет предложено продолжить обновление. При продолжении процесс обновления удаляет нешифрованные записи. В противном случае процесс обновления завершится.
Если у вас возникнут вопросы во время апгрейда, вы можете связаться с Служба поддержки GitHub. Когда у вас было время и возможность понять влияние, вы можете получить обновление.