gitlab-普通用户使用指南.docVIP

GitLab 普通用户使用指南 简介 GitLab作为一种仓库管理系统的开源项目，使用Git可以很好地管理项目的代码，从而帮助管理项目。Git给用户提供了创建并使用项目、创建并邀请用户加入项目组等功能。在高级软件工程课程中，Git主要是作为辅助工具来使用。 修改密码 在开始使用之前，管理员已经为每个用户注册好了账号，用户登录之后，要先修改密码（登录后直接进入修改密码界面，见图1），密码为八位字符串。 图1 修改密码 修改密码之后，重新登录系统，可以对Git进行下一步的操作。 创建项目组 项目在多数的情况下要由项目组员配合完成，因此，用户在使用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中点击“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 HYPERLINK mailto:git@XXX.XXX.X.X:groupforuserguide/zzcproject1.git 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的命