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