如何在Linux上使用GitLab进行问题跟踪

在 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 进行编辑、关闭与指派操作。