GitLab 普通用户使用指南.docxVIP

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 gitXXX.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 $your_email命令，然后就是按照提示输入，基本上全是按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界面。其中就有提交列