关于 GitHub Enterprise Server 升级的已知问题
GitHub 知道以下问题，这些问题可能会影响对 GitHub Enterprise Server 新版本的升级。 有关详细信息，请参阅 GitHub Enterprise Server 发行说明中的“已知问题”。
GitHub 强烈建议定期备份实例的配置和数据。 在继续处理任何升级之前，请备份实例，然后在过渡环境中验证备份。 有关详细信息，请参阅 使用备份实用程序在实例上配置备份 和 设置暂存实例。
解除升级到版本 3.15 及更高版本的暂停
我们已解除了升级到版本 3.15、3.16 和 3.17 的暂停。 现在可以升级到 3.15.12、3.16.8、3.17.5 或更高版本。 我们不建议升级到 3.15、3.16 或 3.17 的早期版本。 作为附加步骤，建议在升级之前检查系统容量。 请参阅“升级前检查系统容量”。
我们延长了 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 的补丁。
Elasticsearch 升级
在将 GitHub Enterprise Server 升级到版本 3.13 或更高版本时，将升级 Elasticsearch 服务。 GitHub 强烈建议遵循“准备 GitHub Enterprise Server 3.13 中的 Elasticsearch 升级”中的指导。
从 3.14 升级到 3.16.0
如果使用的是 GitHub Enterprise Server 3.14，并且默认情况下已在组织级别启用了安全产品，则无法直接从 3.14 升级到 3.16.0。 要确定你的升级资格，请运行以下命令：
ghe-console -y
Organization.any? { |o| [o.vulnerability_updates_enabled_for_new_repos?, o.security_alerts_enabled_for_new_repos?, o.dependency_graph_enabled_for_new_repos?, o.advanced_security_enabled_on_new_repos?, SecretScanning::Features::Org::TokenScanning.new(o).secret_scanning_enabled_for_new_repos?, SecretScanning::Features::Org::PushProtection.new(o).enabled_for_new_repos?].any? }
如果命令返回 true，则从 3.14 直接升级到 3.16.0 将失败，建议等待下一个 3.16 补丁版本以进行升级。
或者，可以先从 3.14 升级到 3.15，再从 3.15 升级到 3.16.0，以此方法立即迁移到 3.16.0。
升级到 3.16.0 和 3.17.0 时，将执行代码扫描功能的慢速数据迁移流程
已启用代码扫描的客户在升级到 3.16.0 版本时可能会遇到升级过程变慢的情况，这是由于数据模型变更引发数据迁移所致。 我们建议先在非生产环境中测试此升级，因为这可能导致比预期更长的停机时间。 [更新日期：2025-06-12]