Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

升级要求

对 GitHub Enterprise Server 进行升级之前,请查阅升级策略规划的建议和要求。

注意:

  • GitHub Actions、GitHub Packages、GitHub Mobile 和 GitHub Advanced Security 等功能在 GitHub Enterprise Server 3.0 或更高版本中可用。 我们强烈建议升级到 3.0 或更高版本,以利用关键安全更新、错误修复和功能增强。
  • 为受支持版本提供的升级包位于 enterprise.github.com。 验证完成升级所需的升级包的可用性。 如果升级包不可用,请联系 GitHub Enterprise 支持 获得帮助。
  • 如果您使用 GitHub Enterprise Server 集群,请参阅 GitHub Enterprise Server 集群指南中的“升级集群”,了解集群特有的说明。
  • GitHub Enterprise Server 版本说明提供了 GitHub Enterprise Server 每一版本的新功能一览表。 更多信息请参阅版本页面

建议

  • 尽量减少升级过程中的升级次数。 例如,不要从 GitHub Enterprise 3.3 升级到 3.4 再升级到 3.5,而应从 GitHub Enterprise 3.3 升级到 3.5。 使用 升级助手 查找当前发行版的升级路径。
  • 如果您的版本比最新版本低� 个版本,请通过升级过程的每一步骤尽量将 您的 GitHub Enterprise Server 实例 升级为更高版本。 在每次升级时尽可能使用最新版本,这� �一来您可以充分利用性能改进和错误修复。 例如,您可以从 GitHub Enterprise 2.7 升级到 2.8 再升级到 2.10,但从 GitHub Enterprise 2.7 升级到 2.9 再升级到 2.10 会在第二步中使用更高版本。
  • 升级时使用最新补丁版本。 浏览到 GitHub Enterprise Server 发行版页面。 在要升级到的版本旁边,单击 Download(下载),然后单击 Upgrading(升级)选项卡。
  • 使用暂存实例测试升级步骤。 更多信息请参阅“设置暂存实例”。
  • 如果运行多次升级,两次功能升级之间至少应间隔 24 小时,以便使数据迁移和后台升级任务能够彻底完成。
  • 在升级虚拟机之前拍摄快照。 更多信息请参阅“生成快照”。
  • 确保您最近成功备份了实例。 更多信息请参阅 GitHub Enterprise Server 备份实用程序 README.md 文件

要求

  • 您必须从最近两个版本的功能版本开始升级。 例如,要升级到 GitHub Enterprise 3.5,您必须使用 GitHub Enterprise 3.4 或 3.3。
  • 使用升级包进行升级时,请为 GitHub Enterprise Server 最终用户安排维护时段。
  • 您可以使用热更新将 GitHub Enterprise Server 升级为最新的补丁版本,它不需要维护时间窗,通常不需要重启。

您可以使用热更新来升级到更新的补丁版本,但不能升级到功能版本。 例如,您可以从 2.10.1 升级到 2.10.5,� 为它们属于相同的功能系列,但不能从 2. 0.9 升级到 2.11.0,� 为它们处于不同的功能系列中。

  • 如果受影响的服务(例如内� �、MySQL 或 Elasticsearch)需要重启 VM 或服务,热补丁可能需要停机一段时间。 需要重启时,系统会通知您。 您可以在稍后完成重启。
  • 通过热补丁升级时,必须提供额外的� �存储,� 为热补丁会安装某些服务的多个版本,直至升级完成。 如果� �磁盘存储空间不足,运行前检查将发出通知。
  • 通过热补丁进行升级时,您的实例负荷不能过大,否则可能影响热补丁过程。
  • 升级到 GitHub Enterprise Server 2.17 会将您的审� �日志从 ElasticSearchElasticSearch 迁移到 MySQL。 这种迁移还会增� 恢复快照所需的时长和磁盘空间大小。 迁移之前,请使用此命令检查 ElasticSearch 审� �日志索引中的字节数:
    curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes
    使用此数字估算 MySQL 审� �日志将需要的磁盘空间大小。 该脚本还会在导入过程中监视可用磁盘空间大小。 在可用磁盘空间大小接近于迁移必需的磁盘空间大小时,监视此数字尤为重要。

About minimum requirements for GitHub Enterprise Server 3.0 and later

Before upgrading to GitHub Enterprise Server 3.0 or later, review the hardware resources you've provisioned for your instance. GitHub Enterprise Server 3.0 introduces new features such as GitHub Actions and GitHub Packages, and requires more resources than versions 2.22 and earlier. For more information, see the GitHub Enterprise Server 3.0 release notes.

Increased requirements for GitHub Enterprise Server 3.0 and later are bold in the following table.

User licensesvCPUsMemoryAttached storageRoot storage
Trial, demo, or 10 light users4
Up from 2
32 GB
Up from 16 GB
150 GB
Up from 100 GB
200 GB
10 to 3,0008
Up from 4
48 GB
Up from 32 GB
300 GB
Up from 250 GB
200 GB
3,000 to 500012
Up from 8
64 GB500 GB200 GB
5,000 to 800016
Up from 12
96 GB750 GB200 GB
8,000 to 10,000+20
Up from 16
160 GB
Up from 128 GB
1000 GB200 GB

For more information about hardware requirements for GitHub Actions, see "Getting started with GitHub Actions for GitHub Enterprise Server."

有关为现有实例调整资源的更多信息,请参阅“增� 存储容量”和“增�  CPU 或内存资源”。

后续步骤

查看这些建议和要求后,您可以对 GitHub Enterprise Server 进行升级。 更多信息请参阅“升级 GitHub Enterprise Server。”