GitLab Guide

Posted 2021-09-27 -飞鹤-

1. Intro

GitLab是基于Git代码管理工具的一个服务程序，提供Web页面来控制代码远程仓库的创建、分支的创建、代码合并请求、代码Issue管理、代码注释、CI/CD、Code Review、Wiki、代码片段管理等功能。

2. Accout

GitLab为每个用户提供一个帐号，可以为自己个人的工程建立一个远程的分布式节点，保证工程版本的安全性。另外，可以和他人共同维护一个main分支。GitLab目前直接采用249服务器的帐号和密码。大家可以直接登录。

3. Project

由管理员，根据不同分组情况，创建相应的初始main版本，并提供HTTP地址供用户Clone使用。用户可以基于此HTTP进行PULL、PUSH、New Branches、Merge Request等操作。

4. Branch

• 用户进入相应的Project，再点击进入Branches页面(如下图)，选择New Branches即可以填写Branch Name完成创建。
• branch可以选择从branch name，tag，或commit SHA(SHA就是相应版本的校验值)三者之一为基础来创建。
  

5. Tag

进入Tag页面，点击New tag按钮进入下图界面，填写TagName、Message，Create From可以从branch Name/tag/commitSHA三者中选择一个。Release Notes是应对Release页面的功能，一般情况不用修改。

• 进入Commits页面，选择相应的Commit，在Comment区使用quick actions操作即可以快速完成对指定Commit打上Tag，Log Message可写可不写。

6. Fork

Fork不是git原生功能，是git仓库托管服务提供的功能。当你想对一个项目做一些修改，并且短期内不打算合并到协作开发分支时，如果创建一个本地分支，一则此分支需要长期存在，留在本地不太安全，二则本地分支过多会增加切换分支时的复杂度，三则如果推送到远程仓库则会导致远程分支过多。面对上述情况时，可以将项目Fork到GitLab的私人分组存放，如果想合并到开发项目，发起一个合并请求即可。

7. Merge

GitLab页面可以发生分支与分支之间的合并，分支只可以在相同的仓库中。GitLab的Merge Request和Github中Pull Request(PR)作用一样，只是叫法不同。

• 创建完成之后，项目相关人员会收到提醒，Reviewer人员可以开始Review， Maintainer 则可以批准并进行合并。
  
• Reivew可以在此页面进行总的Comment，也可以进入Commit/Changes页面，针对具体的代码具体的行数进行评论。代码提交者可以在此进行回复。

8. Code Review

可以基于Merge Request进行代码合并前的Code Review。
在代码推送到远程仓库之后，同样可以对代码进行评论，来达到一个提交后的Code Review。

9. Other

CI/CD、Issues、Wiki、snippets等功能根据需要选择使用。