运维手册

代码仓库：GitLab 权限、Webhook 与仓库恢复

覆盖项目组授权、受保护分支、构建触发追踪及代码、元数据、对象存储的完整恢复。

代码仓库：GitLab 运维与恢复

GitLab 在图中承担代码仓库能力，本方案覆盖项目组、仓库授权、评审、受控分支和交付事件。虽然 GitLab 自身还有其他能力，本蓝图的构建执行仍以 Jenkins 为主；不能未经评审同时开启两套自动发布，造成重复部署。

仓库克隆只是代码副本，不等于完整平台备份。需求评论、合并请求、成员关系、LFS 与附件需要单独核对。当前手册未建立真实组织、Webhook 或令牌，所有配置和恢复验证待目标环境授权。

登记实际 Self-Managed 或托管服务形态、版本、许可、入口、Git 传输协议、存储及外部认证源。按团队和环境规划项目组，明确创建项目、合并、发布标签和修改保护规则的责任。生产部署所依据分支或标签由评审流程保护，具体功能以实例版本和许可为准。

个人账号用于人类操作，自动化使用有限范围的服务身份。Git 克隆令牌与 Webhook 校验秘密应分离，授权期限、保管位置及轮换负责人必须可查；不要把有管理权限的个人令牌复制给所有 Jenkins 任务。

先建立测试项目，用开发者、评审者、只读者和构建账号分别验证权限。提交中关联禅道需求编号，合并时保留评审和测试证据。为 Jenkins 只选择必要事件，限定分支规则，并用唯一事件标识记录 GitLab 发出、接收端收到和任务创建状态。

迁移已有仓库前核对分支、标签、LFS、子模块、项目可见性和原有集成；先完成只读比对，再确定冻结写入窗口。远程地址切换须通知调用方，并保留经过批准的原访问路径回退方案，不能用强制推送替代迁移差异调查。

检查 Git 拉取与推送延迟、后台任务积压、仓库存储增长、附件或对象存储错误、Webhook 失败及备份新鲜度。页面能打开不等于 Git 协议可用，应使用无敏感数据的试点仓库验证读路径，写路径测试必须在获准分支执行。

复查过期服务令牌、离职成员、长期公开项目以及保护规则变动。大型文件进入普通 Git 历史时先评估治理方案和协作影响，不在巡检时擅自重写所有分支历史。恢复资料按实际数据位置更新，避免对象存储迁移后仍沿用旧备份假设。

网页正常而 SSH 克隆失败，核对入口端口、主机密钥、用户密钥和授权；HTTPS 失败则核对令牌范围、证书和代理。克隆正常但大文件失败，独立检查 LFS 或对象存储访问。提交已推送却未构建，按事件投递、接收鉴权、分支匹配和 Jenkins 排队逐段定位。

若重复构建出现，比较事件标识和两端重试，不先扩大重试次数。发现令牌泄漏或未授权保护规则变更，停止相关发布入口并按批准流程吊销凭据、保留证据和核对历史操作，不能只回滚代码文件。

GitLab 官方说明指出，自管理部署的备份范围有明确例外：对象存储、配置目录、TLS/SSH 材料等需按部署方式另行处理，密钥丢失可能导致加密数据无法解密；恢复还要求匹配创建备份时的版本与类型。GitLab 备份文档

本方案要求建立数据库、Git 仓库、LFS/附件、对象存储、配置与密钥的同批次清单，敏感密钥与普通备份分离保管。恢复在隔离环境阻断 Webhook 和邮件出口，抽查提交摘要、分支标签、合并请求、附件及成员权限，再对照恢复点之后的写入制定补录方案。

证明只读账号不可推送、非授权账号不可修改发布入口、Webhook 校验有效，以及一个提交只对应预期任务。至少恢复一个包含 LFS 或附件的试点项目，不能仅以能登录作为通过标准。缺少一致性备份、恢复版本不匹配、迁移差异未解释或发布触发不受控时，停止切换。

备份策略按 GitLab 备份恢复总览选择与部署规模匹配的方法。构建阶段衔接Jenkins 运维手册，项目状态衔接禅道手册。