升级 GitLab
升级 GitLab 是一个相对简单的过程，但复杂度可能会因以下因素而增加：
- 您使用的安装方式。
- 您当前的 GitLab 版本有多旧。
- 是否正在升级到一个主版本。
如果可能，您应先在测试环境中进行升级测试，测试环境应尽可能模拟生产环境。
您可以查阅官方升级文档了解更多信息。
目录
升级路径
下表包含完整的升级路径。升级时，您需要按顺序升级 Operator 和 GitLab 实例的版本。
| 序号 | Alauda Build of GitLab Operator 版本 |
|---|---|
| 1 | 17.8.z |
| 2 | 17.11.z |
INFO
上述版本号中的 .z 表示该次小版本发布的最新补丁版本。
进行升级时，您应始终使用最新的补丁版本，以确保获得最新的安全更新和错误修复。
每个版本的最新补丁版本可在发行说明中找到。
WARNING
如果您的 GitLab 版本低于 17.8.5，请参考GitLab 数据迁移完成升级。
升级步骤
WARNING
安全升级 GitLab 版本时，请注意以下事项：
- 在升级 GitLab 实例之前，请先完成实例的数据备份。
- 升级 GitLab 需要一定时间，具体取决于 GitLab 数据大小以及当前版本与目标版本之间的版本差距（升级次数）。
- 升级过程中实例将不可用。
升级时，您需要根据升级路径依次升级 版本和实例版本。升级 Operator 不会自动升级实例版本，且升级后的 Operator 不会管理旧的 GitLab 实例，因此您需要及时手动触发实例升级。
升级实例
通过 UI 升级实例
进入 Administrator -> Marketplace -> Operator Hub 页面，切换到目标集群，进入 Alauda Build of GitLab Operator 详情页，点击要升级的实例名称进入实例详情页，点击实例详情页上的升级按钮。
通过 YAML 升级实例
进入 Administrator -> Clusters -> Resources 页面，切换到目标集群，搜索 GitLabOfficial 资源类型，编辑要升级的实例资源，修改 spec.version 字段为目标实例版本并保存。