在 Linux 上使用 GitLab 进行问题跟踪
一 环境准备与安装
- 准备一台 Linux 服务器（建议至少 2 核 CPU、8GB 内存），并开放 HTTP/HTTPS 端口。
- 安装依赖（以 Ubuntu/Debian 为例）：
sudo apt update && sudo apt install -y ca-certificates curl openssh-server postfix
- 添加 GitLab 仓库并安装（以 Ubuntu 18.04 为例）：
curl -LO https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh
sudo bash /tmp/script.deb.sh
sudo apt install -y gitlab-ce
- 配置外部访问地址（编辑 /etc/gitlab/gitlab.rb）：
external_url ‘https://your-domain-or-ip’
- 应用配置并启动服务：
sudo gitlab-ctl reconfigure
- 如启用 HTTPS，可同时配置 Let’s Encrypt 联系人邮箱，便于证书到期提醒。以上步骤完成后，可通过浏览器访问 GitLab Web 界面。
二 创建项目与权限配置
- 登录 GitLab，点击 New Project 创建项目，设置名称、描述与可见性（Private/Internal/Public）。
- 进入 Project → Members 添加成员，并分配角色：Guest、Reporter、Developer、Maintainer、Owner，不同角色对 Issues 等功能的操作权限不同。
- 建议对关键分支（如 main）启用分支保护，仅允许通过 Merge Request 更新，保障主干稳定性。
三 使用 Issues 进行问题跟踪
- 创建问题：进入 Project → Issues → New issue，填写标题、描述、指派给、标签（如 bug、feature、refactor）、截止日期与权重等。
- 讨论与协作：在问题内使用评论、@ 提及、附件、系统备注记录处理过程，保持信息透明。
- 关闭问题：
- 手动关闭：在问题详情页点击 Close issue。
- 提交关联关闭：在合并请求描述或提交信息中使用关键词关闭，例如：
Closes #123
Fixes #456
Related to #789
当合并请求被接受并合并后，对应 Issue 会自动关闭。
- 里程碑管理：进入 Issues → Milestones → New milestone 创建版本里程碑，将相关问题纳入里程碑进行进度跟踪与统计。
- 看板与筛选：使用 Issue Board 以卡片方式拖拽管理状态；通过标签、指派、里程碑、状态等字段进行筛选与视图定制，提升可视化与效率。
四 本地开发闭环与自动化
- 克隆与分支：
git clone
git checkout -b feature/123-fix-login
- 开发与提交：
git add .
git commit -m “Fix login null pointer (Closes #123)”
git push origin feature/123-fix-login
- 创建合并请求：在 GitLab 页面创建 Merge Request（源分支 feature/123-fix-login → 目标分支 main），指派评审人、关联 Issue #123，在 MR 描述中使用上述关键字即可在合并后自动关闭问题。
- 持续集成：在项目根目录添加 .gitlab-ci.yml 定义构建、测试、部署阶段，借助 CI/CD 管道状态把控质量与进度，减少回归风险。
五 最佳实践与常见问题
- 最佳实践：
- 问题描述遵循“现象—复现步骤—期望结果—实际结果”，并附日志或截图，便于快速定位。
- 统一标签体系（如 bug、feature、enhancement、performance、urgent），配合看板与筛选形成高效工作流。
- 用里程碑规划版本，配合 Weight/优先级/截止日期 做迭代管理。
- 通过 分支保护 + Code Review + MR 流程保障质量，避免直接推送主干。
- 常见问题与排查：
- 访问异常：确认服务器防火墙已放行 80/443，域名与 external_url 一致，必要时查看 /var/log/gitlab/ 日志。
- 合并后未关闭问题：检查 MR 描述是否包含正确的关闭关键字（如 Closes #123），以及 MR 是否已合并到目标分支。
- 权限不足：在 Members 中为成员分配合适角色，确保可对 Issues 进行编辑、关闭与指派操作。
