Gitlab Issue Tracker and Wiki

Posted 2020-11-20 zangxueyuan

一. 引用问题

1. 登陆 Gitlab服务器

2. 进入到super-git项目

3. 创建一个问题

4. 查看创建问题的号码，可以在下图找到。

5. 对代码进行提交去关闭这个问题，首先把项目在本机上进行刻隆。

6. 同步代码

[email protected] MINGW64 ~/super-git (awesome-feature)
$ git checkout master &7 git pull
[1] 5108
bash: 7: command not found
Switched to branch ‘master‘
Your branch is up to date with ‘origin/master‘.
[1]+  Done                    git checkout master

7. 创建一个分支，并切换到该分支下

[email protected] MINGW64 ~/super-git (master)
$ git checkout -b bug-fix
Switched to a new branch ‘bug-fix‘

8. 改变代码如下（只是案例）

[email protected] MINGW64 ~/super-git (bug-fix)
$ echo "Let‘s fix this bug" >> README.md

9. 提交改变。

10. 代码推送到gitlab服务器

[email protected] MINGW64 ~/super-git (bug-fix)
$ git push origin bug-fix
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Writing objects: 100% (3/3), 276 bytes | 276.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote:
remote: To create a merge request for bug-fix, visit:
remote:   http://gitlab.aishangwei.net/root/super-git/merge_requests/new?merge_request%5Bsource_branch%5D=bug-fix
remote:
To gitlab.aishangwei.net:root/super-git.git
  * [new branch]      bug-fix -> bug-fix

11. 创建合并请求。

12. 接受合并请求的同时，会关闭相应的问题。如下图所示：

13. 可 看到问题已经处于关闭状态。

二. 工作里程碑

当项目变的越来越大的时候，最好的就是有个好的项目管理好系统。 Gitlab就能做这个事情。上面提过问题追踪和合并请有求，其实可以把那两步合并成工作里程碑中。下面介绍如何使用里程碑最有效。

创建步骤：

1. 登陆Gitlab服务器

2. 切换到super-git项目中。

3. 点击【Issues】按钮菜单。

4. 点击【Milestones】

5. 点击【New Milestone】

6. 创建好后的milestone如下，此时我们可 创建两个或三个问题，或者更多。点击【New issues】

7. 从下图可以看到，创建了三个问题，归属于milestone Version2.5.

8. 当完成所有的问题之后，milestone如下 所示。

三. 配置 wiki

Gitlab提供了一种非常好的方式在项目中去保存项目信息和相关知识点。下面步骤演示如何在Gitlab中创建wiki.

执行步骤：

1. 登陆Gitlab服务器实例。

2. 进入到你想要创建维基百科的项目。

3. 点击【Wiki菜单条目】，点击【New Page】。

4. 创建内容如下。

 

四. 用Gollum管理wiki

1. Gitlab的wiki不仅可以通过web接口管理，也可以通过使用Gollum gem本地的编辑它。

2. 需要安装ruby， 各版本安装参考：https://github.com/gollum/gollum/wiki/Installation

（1）安装gollum截图。

（2）刻隆项目

（3）启动Gollum和本地编辑。

3. 打开浏览器，输入localhot:4567,可以看到文本编辑器，在此处就可以进行编辑了。

4. 编辑完如下图所示：

5. 然后关闭Gollum server, 推送这个改变到Gitlab服务器上。

[email protected] MINGW64 ~/Desktop/super-git.wiki (master)
$ git push
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 6 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 312 bytes | 312.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To gitlab.aishangwei.net:root/super-git.wiki.git
    c6721f5..f142245  master –> master

6. 登入gitlab服务器，进行查看。效果如下