GitLab 普通用户使用指南

GitLab 普通用户使用指南 1. 简介

GitLab作为一种仓库管理系统的开源项目，使用Git可以很好地管理项目的代码，从而帮助管理项目。Git给用户提供了创建并使用项目、创建并邀请用户加入项目组等功能。在高级软件工程课程中，Git主要是作为辅助工具来使用。 2. 修改密码

在开始使用之前，管理员已经为每个用户注册好了账号，用户登录之后，要先修改密码（登录后直接进入修改密码界面，见图1），密码为八位字符串。

图1 修改密码

修改密码之后，重新登录系统，可以对Git进行下一步的操作。 3. 创建项目组

项目在多数的情况下要由项目组员配合完成，因此，用户在使用Git的时候，第一步需要做的就是要创建组。创建项目组之后，将其他项目成员邀请进入该组。创建和邀请的功能由一个组员完成就可，不需要多人重复操作。修改密码之后，会自动退出至登录界面，重新登录之后，进入Git的欢迎界面，见图2.

图2 欢迎界面

若是管理员赋予了该登录用户新建工程和组的权限，那么，在欢迎界面中，就可以看到

普通用户最基本的功能是新建工程、新建组、以及参加公有工程。在新建项目组功能中，点击“New group”，可以进入新建项目组的界面，见图3.

图3 新建组

在图3所示的界面中，依次输入项目组名、详细信息、说明文件（可选），点击“Create Group”就可以完成新建项目组的功能。新建项目组之后，会进入图4所示的界面，界面显示当前只有一个组“GroupForUserGuide”。并且在此也可以点击“New project”，新建工程。创建好项目组后，就要在项目组中添加组员，点击图4中的“Members”选项，进入图5所示的邀请组员界面。

图4 新建组后跳转到首页

点击图5中的“Add members”，就可进入图6所示的界面。在图6中，可以添加组员，并且为组员设置权限。在高级软件工程课程中，组长邀请组员的时候，只需要将组员权限设置成Developer就可。将多个组员邀请进入项目组之后，就可以新建工程了。

图5 邀请组员功能首页

图6 确定组员的权限

4. 创建工程

在图4中点击“New project”就可以进入如图7所示的新建工程的界面（点击图2，图4，图5中的Activity就可以进入图4）。完成输入工程名、选择namespace(就是选择项目组或组员)、输入描述、设置可见度等功能之后，点击“Create project”就可以完成新建工程。在高级软件工程课程中，将项目的可见度设置为Private，即只有组员可以看到。

图7 新建工程

完成新建工程之后，就会进入图8所示的界面，该界面主要是配置本地git。在此，要将git安装完成，安装之后，本地会有两个操作接口Git GUI 和Git Bash。Git GUI是Git的图形化界面，完成文件的上传等功能；GIt Bash是Git的命令行界面，可用于Git配置， Bash的界面如图9所示。

图8 工程配置信息列表

图9 Bash

在Bash中依次输入图8中黑色区域的Git global setup, Create Repository中的设置，就可以完成配置。Create Repository的第一和七个命令需要注意。Git默认将工程的文件夹设置在C：/Users/user内，因此，在执行第一个命令（mkdir…）之前，要设置自己的文件夹地址。可以使用cd命令进入工程在本地的文件夹的地址，例如：cd /d/ase/project。然后执行“mkdir”命令。在第七个命令中，需要将”@”和”：”之间的信息改成GitLab的IP地址，例如：git remote add origin git@XXX.XXX.X.X:groupforuserguide/zzcproject1.git。执行完“git push -u origin master”之后，要获得工程的SSH KEY，才可以进行下一步的配置（此时不要关闭Bash）。点击图8中红色区域“add an SSH key”可以进入图10所示的SSH key的输入界面。

图10 输入SSH KEY

但是此时还没有SSH KEY，因此需要先获得该SSH KEY。点击图10中的SSH Keys选项，就可以进入获取SSH KEY的界面，见图11.

图11 SSH Keys 详细信息

点击Add SSH Key就可以进入SSHKEY的输入界面，如图12。点击图12中的“The SSH help page”(最好在浏览器的新标签页打开)，进入SSH HELP界面，如图13

图12 输入SSH KEY

图13 SSH HELP

点击“SSH”可以进入获取SSH KEY的命令列表界面，见图14.

图14 获取SSH KEY的命令

然后返回Git Bash，在其中输入ssh-keygen -t rsa -C \命令，然后就是按照提示输入，基本上全是按Enter键。就可以在C盘的Users/当前用户文件夹里看到.ssh文件夹，内有id_rsa,id-rsa.pub,know_hosts三个文件。打开id-rsa.pub，内部就是SSH KEY。将其全部复制到图12的key输入框中，然后点击Title，就可看到自动添加了title，然后点击Add Key，就可以完成添加SSH KEY。

这样，GIT就基本配置完成。 5. 文件上传与更新

工程以及本地文件夹设置好之后，就可以上传和更新工程的文件。首先，将需要上传的文件复制到本地的工程目录中，然后点击鼠标右键，选择“Git Add all files now”；然后选择“Git Commit Tool”,从而打开Git GUI，见图15.

图15 Git GUI 上传文件

在后下角的输入框内，要填写描述，然后点击提交。而后在Bash中输入命令git push –u origin master.就可以完成提交。点击界面中的，就可以看到图16所示的Activity界面。其中就有提交列表。点击进入提交列表，就可以看到提交的详细信息。

图16 提交列表

在Git GUI中，分支选项中有Checkout选项，可以更新工程文件。 6. 其他

在上面可以看出，Git的上传和更新步骤比较繁琐，因此，可能会有其他简单的方式完成上传和更新，请同学们多加探讨。

本文来源：https://www.bwwdw.com/article/prdf.html