ubuntu gitlab项目管理实践

Ubuntu环境下GitLab项目管理实践指南

一、GitLab环境准备与安装

在Ubuntu上部署GitLab前，需完成系统初始化及依赖安装：

1. 系统更新与依赖安装：运行sudo apt update && sudo apt upgrade -y更新系统包；安装必要依赖sudo apt install -y curl openssh-server ca-certificates tzdata perl（支持GitLab运行及SSH连接）。
2. 添加GitLab官方源：通过curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash添加GitLab社区版（CE）的APT源。
3. 安装与配置GitLab：执行sudo apt install gitlab-ce安装GitLab；编辑配置文件sudo vim /etc/gitlab/gitlab.rb，设置external_url（如http://your_server_ip或域名），若需邮件通知则配置SMTP参数（如gitlab_rails['smtp_enable'] = true）；运行sudo gitlab-ctl reconfigure应用配置，sudo gitlab-ctl start启动服务。
4. 访问与初始设置：通过浏览器访问http://your_server_ip，使用默认管理员账号root及初始密码（可通过cat /etc/gitlab/initial_root_password查看）登录，修改密码并完成基础配置。

二、项目创建与权限管理

1. 创建项目：登录GitLab后，点击顶部导航栏“New Project”，填写项目名称（如my-web-app）、描述，选择可见性级别（Private/Private/ Internal，建议团队项目设为Private），点击“Create Project”即可生成代码仓库。
2. 权限控制：通过“Project Settings → Members”添加团队成员，分配角色（Owner/Admin/Developer/Reporter/Guest），精细化控制其对项目的访问权限（如Developer可推送代码，Reporter仅能查看）。

三、分支管理与代码协作

1. 分支策略：推荐采用Git Flow工作流（主分支main/master用于稳定发布，开发分支develop用于集成，特性分支feature/*用于功能开发，修复分支hotfix/*用于紧急bug修复），确保代码稳定性与可追溯性。
2. 本地开发与推送：团队成员通过git clone git@your_server_ip:username/project_name.git（SSH）或git clone https://your_server_ip/username/project_name.git（HTTPS）克隆仓库；本地修改后执行git add .（添加变更）、git commit -m "commit message"（提交说明）、git push origin feature/branch-name（推送至远程特性分支）。

四、CI/CD自动化集成

1. 配置.gitlab-ci.yml：在项目根目录创建.gitlab-ci.yml文件，定义CI/CD流水线（如构建、测试、部署）。示例配置：

   stages:
     - build
     - test
     - deploy
   build_job:
     stage: build
     script:
       - echo "Building the project..."
   test_job:
     stage: test
     script:
       - echo "Running tests..."
   deploy_job:
     stage: deploy
     script:
       - echo "Deploying the project..."
     only:
       - main  # 仅main分支变更时触发部署
   

   该配置会在每次推送代码时自动触发流水线，依次执行构建、测试、部署任务。
2. 流水线查看：在项目页面点击“CI/CD → Pipelines”，可查看流水线运行状态（成功/失败）、日志输出及每个job的执行详情。

五、问题跟踪与看板管理

1. 问题（Issues）管理：通过“Project → Issues”创建问题，填写标题、描述（可关联里程碑、标签），分配给指定成员，设置优先级（High/Medium/Low）。问题支持评论、附件上传及状态流转（Open/In Progress/Closed）。
2. 看板（Kanban）可视化：点击“Project → Boards”，进入看板页面。看板以卡片形式展示问题，支持拖拽调整状态（如从“To Do”拖至“Doing”），直观反映项目进度，提升团队协作效率。

六、代码审查与合并

1. 合并请求（Merge Request）：当特性分支开发完成后，在GitLab页面点击“Merge Requests → New merge request”，选择源分支（如feature/login）与目标分支（如develop），填写变更说明（可关联Issue），点击“Create merge request”。
2. 代码审查与合并：团队成员在合并请求页面查看代码变更，通过“Comments”提出修改建议；作者修改后推送至源分支，评论会自动更新。审查通过后，具备权限的成员（如Maintainer）点击“Merge”将源分支合并至目标分支，合并后可选择删除源分支。

七、监控与维护

1. 性能优化：GitLab运行需足够硬件资源（建议至少2核CPU、4GB内存、50GB SSD）；启用Redis缓存（默认开启）加速数据处理；使用SSD存储提升IO性能。
2. 监控与日志：通过“Admin Area → Monitoring → Prometheus”查看系统资源（CPU、内存、磁盘）使用情况，结合Grafana实现可视化监控；定期清理过期日志（如/var/log/gitlab下的日志文件），避免日志过大占用磁盘空间。
3. 备份与恢复：配置自动备份（编辑/etc/gitlab/gitlab.rb，设置gitlab_rails['backup_keep_time'] = 604800（保留7天）），运行sudo gitlab-backup create手动触发备份；恢复时停止GitLab服务，执行sudo gitlab-backup restore BACKUP=timestamp，恢复后重启服务。