集成配置
适用角色：管理员
前置条件：已准备好 Git 服务端（GitLab／Gitea／GitHub 等）
本篇覆盖两件事：登记仓库（让平台知道有哪些仓库可导入）与配置凭证（让平台能访问这些仓库）。
一、Git 仓库管理
| 列 | 说明 |
|---|---|
| 仓库名称 | 显示用名称 |
| 仓库地址 | Git 仓库 URL |
| 说明 | 备注 |
| 所属分组 | 哪些分组能看到该仓库 |
| 操作 | 编辑、删除 |
注意 · 「Git 仓库管理」是全局仓库目录。用户在自己的工作空间里点「导入仓库」时，可以直接选择这里登记过的仓库，也可以手填地址。
1.1 新增仓库
| 字段 | 必填 | 限制 | 说明 |
|---|---|---|---|
| 仓库名称 | ✅ | ≤ 100 字符 | 如「项目前端仓库」 |
| 仓库地址 | ✅ | ≤ 500 字符 | 如 https://github.com/username/repo.git |
| 仓库说明 | ❌ | ≤ 500 字符 | 简要说明 |
| 所属分组 | ❌ | — | 留空 = 仅管理员可见 |
1.2 编辑仓库
1.3 删除仓库
注意 · 删除的是仓库登记条目，不会删除 Git 服务端上的实际仓库，也不会影响用户已克隆到工作空间的副本。
二、Git 凭证
凭证管理分两个页签：SSH 密钥与 HTTP 凭证。
2.1 SSH 密钥
| 列 | 说明 |
|---|---|
| 用户 | 密钥归属的用户 |
| 名称 | 密钥名，如 gitlab_key |
| 类型 | ED25519／RSA 4096 |
| 指纹 | 密钥指纹，用于核对 |
| 创建时间 | — |
| 操作 | 复制公钥、删除 |
生成新密钥
| 字段 | 说明 |
|---|---|
| 用户 | 密钥归属 |
| 密钥名称 | 只能含字母、数字、下划线、连字符 |
| 密钥类型 | ED25519（推荐，安全性与性能更好）／RSA 4096（4096 位，兼容性更好） |
使用流程：
- 点「生成新密钥」，平台为该用户创建密钥对
- 点「复制公钥」，把公钥内容提供给用户
- 用户把公钥添加到 GitLab 的 SSH Keys 设置
- 公钥添加后即可通过 SSH 访问仓库
注意 · 私钥已加密存储在数据库，平台不会在任何界面显示私钥明文。删除密钥后需重新生成，请确保已在 GitLab 等平台移除对应公钥。
2.2 HTTP 凭证
设置凭证
| 字段 | 必填 | 说明 |
|---|---|---|
| 用户 | ✅ | 凭证归属的用户 |
| Git 用户名 | ✅ | Git 服务端用户名 |
| Git 密码 | ✅ | 密码或访问令牌 |
注意 · 修改时留空表示保持原密码不变。
2.3 两种凭证怎么选
| 协议 | 用哪种 | 配置位置 |
|---|---|---|
git@host:group/repo.git | SSH 密钥 | GitLab → Settings → SSH Keys |
https://host/group/repo | HTTP 凭证 | GitLab → Settings → Access Tokens |
提示 · HTTP 凭证在部分 Git 服务上需要用访问令牌而非登录密码，且通常需要勾选
read_repository／write_repository权限。
三、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 导入仓库提示认证失败 | 未配凭证，或凭证归属的用户与操作人不一致 | 按用户补配凭证 |
| 仓库看不到 | 未分配分组，或分组为空（仅管理员可见） | 编辑仓库 |
| 密钥删不掉 | 可能仍被某仓库使用 | 先确认引用关系 |
| SSH 一直要求输入密码 | 公钥未添加到 GitLab | 走完「使用流程」第 3 步 |
| HTTP 凭证改了不生效 | 留空时表示保持原密码 | 需输入新密码才覆盖 |
| 导入仓库时提示文件已存在 | 目标目录有同名文件 | 选择覆盖或跳过 |
四、相关页面
| 页面 | 内容 |
|---|---|
| 资产 | 把仓库设为技能库／重要文档库 |
| 工作台 · 导入仓库 | 用户侧导入 |
| 基础配置 | 机构、系统参数、数据字典 |