ubuntu中gitlab如何管理项目

Ubuntu中GitLab项目管理全流程指南

1. 安装GitLab

在Ubuntu上安装GitLab需先更新系统包，再添加GitLab官方源并安装：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装依赖包（含SSH、CA证书、Postfix邮件服务）
sudo apt install -y curl openssh-server ca-certificates postfix

# 添加GitLab CE源
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

# 安装GitLab CE
sudo apt install gitlab-ce

# 配置并启动GitLab（设置external_url，如http://your-server-ip）
sudo vim /etc/gitlab/gitlab.rb  # 修改external_url
sudo gitlab-ctl reconfigure    # 应用配置
sudo gitlab-ctl start          # 启动服务

安装完成后，通过http://your-server-ip访问GitLab Web界面，使用默认管理员账号root登录并修改密码。

2. 创建项目

登录GitLab后，通过以下步骤创建项目：

点击左侧导航栏Projects → 右上角New Project。
填写项目信息：Name（必填）、Description（可选）、Visibility Level（选择Private/Internal/Public）。
可选勾选Initialize with a README（自动生成README文件）。
点击Create Project完成创建。

3. 代码版本控制

本地仓库关联远程

在本地项目目录中，执行以下命令关联GitLab远程仓库：

# 克隆项目（选择HTTPS或SSH方式）
git clone http://your-gitlab-ip/username/project-name.git
cd project-name

# 添加文件到暂存区
git add .

# 提交更改到本地仓库
git commit -m "Initial commit"

# 推送到GitLab远程仓库（默认master分支）
git push origin master

分支管理

推荐使用Git Flow工作流（master主分支用于稳定版本，develop开发分支用于整合代码，feature/*功能分支用于开发新功能）：

# 创建功能分支
git branch feature/new-login

# 切换到功能分支
git checkout feature/new-login

# 开发完成后合并到develop分支
git checkout develop
git merge feature/new-login

# 推送分支到远程
git push origin feature/new-login

可通过GitLab Web界面直接创建/删除分支，或在本地使用git branch命令管理。

4. 团队协作与权限管理

添加成员

进入项目→点击Members→输入成员用户名/邮箱→选择角色（Guest/Reporter/Developer/Maintainer/Owner）→点击Add。
角色权限说明：
- Guest：仅查看项目信息；
- Reporter：查看+下载代码+创建Issue；
- Developer：查看+推送代码+创建Merge Request；
- Maintainer：管理项目设置+审批Merge Request；
- Owner：完全控制项目（删除/转让）。

权限设置

项目可见性：Private（仅邀请成员可见）、Internal（所有登录用户可见）、Public（所有人可见）。
仓库权限：通过Settings→Repository设置Push/Pull权限，限制分支推送（如保护master分支，仅Maintainer可推送）。

5. 任务与问题跟踪

使用Issues功能管理项目任务：

进入项目→点击Issues→点击New Issue。
填写标题、描述（支持Markdown）、标签（如bug/feature）、优先级（Low/Medium/High）。
可指派给特定成员，设置截止日期，关联Milestone（里程碑）。
通过Kanban Board（看板）可视化任务进度，拖动Issue到不同状态（To Do/In Progress/Done）。

6. CI/CD集成

通过.gitlab-ci.yml文件实现自动化构建、测试、部署：

在项目根目录创建.gitlab-ci.yml文件，定义流水线阶段（stages）和任务（jobs）。

示例（Python项目自动测试）：

stages:
  - test

test_job:
  stage: test
  script:
    - pip install -r requirements.txt
    - pytest

推送代码到远程仓库后，GitLab会自动触发流水线，可在CI/CD→Pipelines查看执行结果。

7. 文档与知识共享

Wiki：进入项目→点击Wiki→创建页面（支持Markdown），用于编写项目文档、API说明等。
Snippets：点击Snippets→创建代码片段，分享常用代码或配置，支持语法高亮。

8. 监控与维护

监控系统状态：通过GitLab Web界面Admin Area→Monitoring→Dashboard查看CPU、内存、磁盘使用情况。
日志管理：使用gitlab-ctl tail命令实时查看GitLab日志，或通过Admin Area→Logs查看详细日志。
备份与恢复：配置自动备份（修改/etc/gitlab/gitlab.rb中的gitlab_rails['backup_keep_time']参数），定期测试恢复流程（gitlab-backup restore）。
更新GitLab：通过apt升级（sudo apt update && sudo apt install gitlab-ce），升级前备份数据。