创建升级计划

创建升级计划需要记录以下内容：

• 升级实例的步骤。
• 升级不顺利时的应对步骤。

您的升级计划应包括：

• 如何升级 GitLab，包括在可能且必要时进行 零停机升级。
• 如何在必要时 回滚 GitLab。

与支持团队协作

如果您正在与 支持团队 合作审核您的升级计划，请记录并分享以下问题的答案：

• GitLab 是如何安装的？
• 节点的操作系统是什么？请检查 支持的平台 以确认有可用的后续更新。
• 是单节点还是多节点设置？如果是多节点，请记录并分享每个节点的架构细节。使用了哪些外部组件？例如，Gitaly、PostgreSQL 或 Redis？
• 您是否在使用 GitLab Geo？如果是，请记录并分享每个次要节点的架构细节。
• 在您的设置中，还有哪些可能重要或独特的方面？
• 您当前使用的 GitLab 版本是否遇到任何已知问题？

回滚计划

升级过程中可能会出现问题，因此为这种情况制定回滚计划至关重要。一个完善的回滚计划能清晰地指导您将实例恢复到最后一次正常工作的状态。它包括备份实例和恢复实例的方法。您应该在需要之前测试回滚计划。有关回滚所需步骤的概述，请参阅 降级。

备份 GitLab

创建 GitLab 及其所有数据（数据库、仓库、上传文件、构建产物、工件、LFS 对象、注册表、页面）的备份。这对于在升级出现问题时能够将 GitLab 回滚到正常工作状态至关重要：

• 创建 GitLab 备份。 请根据您的安装方法遵循相关说明。不要忘记备份 密钥和配置文件。
• 或者，创建您的实例快照。如果是多节点安装，必须为每个节点创建快照。 此过程不在 GitLab 支持范围内。

恢复 GitLab

如果您有一个模拟生产环境的测试环境，您应该测试恢复过程，以确保一切按预期工作。

要恢复您的 GitLab 备份：

• 恢复前，请务必了解 先决条件，最重要的是，备份的 GitLab 版本和新 GitLab 实例的版本必须相同。
• 恢复 GitLab。 请根据您的安装方法遵循相关说明。确认 密钥和配置文件 也已恢复。
• 如果从快照恢复，请了解执行此操作的步骤。 此过程不在 GitLab 支持范围内。