gitlab 多人协同工作

Gitlab多人协同工作 Master & Developer目录
 开发前准备
 开发中过程
 Developer操作说明
 Master操作说明
 附录（Gitlab基本操作）开发前准备开发前准备
Gitlab多人协同工作，所有开发者会被添加进一个共同的工作组。协同工
作开始前，群组管理员及开发者都有一些准备工作要做。
群组管理员（Master）：
1 -在Gitlab上创建群组
2 -为群组添加成员并赋予权限
3 -为群组新建项目
4 -为群组项目创建分支
开发者（Developer）：
1.去Gitlab注册个人账号并添加个人SSH Key（参照本PPT附录）
2.请群组管理员将你的账号添加进open-source群组开发中过程开发中过程
日常开发中开发者与群组管理员的分工。
开发者（Developer）：
1. 克隆远程仓库到本地（只在第一次做一次）
2. 获取远程最新版本并merge到本地
3. 切换到自己的分支
4. 在自己的分支上写代码并提交
5. 将自己分支的更新push到远程
6. 在Gitlab上发起请求，请求合并自己的分支到远程的master分支
群组管理员（Master）：
1. 管理员收到合并请求，审查代码并决定是否通过合并请求Developer开发者Workflow
Gitlab建议的协同工作流开发者Workflow
①克隆管理员创建好的项目到本地
②切换到自己的分支
③在自己的分支上写代码并提交
④push到远程服务器(分支是自己
的分支)开发者Workflow
⑤在commit页面上浏览分支
Projects -> 项目名称-> Repository -> Commits -> 选择自己的分支，点击单个链接可以看到更新的具体内容。开发者Workflow
点击Merge Requests -> New Merge Request，在New Merge Request页面选择自己要合并的分支和要并入的分支
（master），点击Compare branches and continue继续。
下拉选择自己的分支 被合并的分支，master
⑥在Gitlab页面创建一个合并请求开发者Workflow
开发者操作总结：
1. 克隆管理员创建好的项目到自己本地
2. 切换到自己的分支（分支由管理员创建）
3. 在自己的分支上写代码，并提交
4. 推送到远程服务器，分支是自己的分支
5. 在commit页面上浏览分支
6. 创建一个合并请求
其中：远程仓库由管理员创建，开发者使用的分支也由管理员事先创建。开发者在Gitlab页面上创建了合并请求
之后，由管理员审查代码并最终通过合并请求，完成分支到主分支的合并。MasterMaster – 创建群组
左侧菜单Project -> Groups -> New Group，填入群组名称和描述，选择权限选项点击Create group提交。
写入Group名称
写入Group描述
群组和群组下的Projects仅对群内部成员可见
Gitlab登录用户均可见
所有人都可见，没有任何权限管控Master - 添加群组成员
左侧菜单Group -> 单击群组名称-> Members进入该群组成员管理页面，按照指引添加成员
从下拉菜单选择要添加的用户
设定权限 过期时间，不写为永久有效
开发人员的权限级别，由低到高依次是
Guest，Reporter，Developer，Maste。一般
给需要提交代码的开发者权限为DeveloperMaster - 新建群组项目
单击左边菜单栏，选择Group -> 单击群组名称-> New Project，按照指引新建项目。Master – 为群组项目创建分支
进入Project页面，在SSH地址栏右边点+，下拉菜单中选择New branch，创建新的分支。
写入Group名称Master – 为群组项目创建分支
进入Project页面，在SSH地址栏右边点+，下拉菜单中选择New branch，创建新的分支。
分支的命名规则使用小驼峰式命名法，具体为开发
人员工号+所开发的功能/要解决的BUG名，工号首
字母小写。命名中不要使用特殊字符，不要使用点。
分支命名：
f1322817Feature1
f1322817Bug051Master – 合并分支
管理员收到合并请求，审查代码并决定是否通过合并请求。点击Accept Merge Request通过，代码完成合并。附录
Gitlab基本操作1.用户注册
按要求填写完所有项目之后单击Register提交。2.添加个人SSH KEY
在自己电脑上新开Git Bash窗口，用命令ssh-keygen.exe –t rsa生成SSH公钥。在隐形文件夹.ssh下生成的id_rsa.pub
即为SSH公钥文件。2.添加个人SSH KEY
单击用户头像，选择Settings。2.添加个人SSH KEY
复制公钥文件内容，贴到Key的框框中，
点击Add Key.
复制过程中不能有换行。
一个公钥（一台主机）只能被一个用
户使用。
单击SSH Keys切换到SSH Keys配置页面。复制刚才本地生成的公钥文件内容，贴到Key的框框中，点击Add Key添加。2.添加个人SSH KEY
至此，个人SSH KEY添加完成。3.新建project
单击左边菜单栏，选择Projects -> New Project3.新建project
写入项目名称，和项目描述，点击Create project。
Visibility Level根据实际需要选择。3.新建project
Project创建完成之后，会产生一个以project.git命名的仓库。剩下就是用git上传下载代码，管理自己的项目。4.导入项目
在本地主机并设置下git的用户名和邮箱。
③查看当前git配置
①设置用户名
②设置邮箱4.导入项目
如果项目在本地已经存在，需要导入到gitlab，可以通过命令直接将项目导入上去。
⑤提交
①进入项目文件夹
②初始化git仓库
③添加远程仓库
④将项目文件存进暂存区
⑥将更新推送到远程git仓库4.导入项目
如果本地没有项目仓库，可以从gitlab上把项目克隆下来。
①克隆远程仓库到本地电脑
②进入项目文件夹
③查看项目文件目录4.导入项目
如果已经拉取过远程仓库，每次在本地编辑代码之前，应该从远程获取最新版本并merge到本地。5.分支(branch)操作
查看分支：git branch
①查看本地分支
②查看远程分支5.分支(branch)操作
创建本地分支并切换到分支：git branch [name] , git checkout [name]
①创建本地分支
②切换分支
③创建新分支并立即切换到新分支，
等同于上面两条命令5.分支(branch)操作
删除本地分支：git branch -d [name]。注意删除分支时该分支不能存在还未合并的代码。
①删除本地分支5.分支(branch)操作
创建远程分支：（创建本地分支，并push到远程）git push origin [name]
①将本地分支push到远程5.分支(branch)操作
删除远程分支：git push origin :[name]
①删除远程分支
把本地某个分支提交到远程仓库，并作为远程仓库的分支，完整命令是：git push origin [name]:[name]。
删除远程分支的命令其实就是让左边的分支为空，其作用是删除远程的分支。但是该分支在本地还是会保存的。5.分支(branch)操作
合并分支：git merge [name]
③提交修改
①切换到f1322817Feature2分支
②修改一个/多个文件
④切换回master分支
⑤合并f1322817Feature2的修改到master分支6.子模块(submodule)操作
添加子模块：git submodule add [url][path]
①添加子模块6.子模块(submodule)操作
初始化子模块：git submodule init
①初始化子模块，只需要在首次拉取的时候运行一次。6.子模块(submodule)操作
更新子模块：git submodule update
①更新子模块，每次更新或切换分支后都需要运行一下。
submodule项目和它的父项目本质上是2个独立的git仓库。只是父项目储存了它依赖的submodule项目的版本号而
已。如果同组的同事更新了submodule，然后更新了父项目中依赖的版本号，你需要在git pull之后，调用git
submodule update来更新submodule的信息。6.子模块(submodule)操作
删除子模块，有4个步骤
①git rm -cached 子模块
②编辑.gitmodules，将子模块相关配置节点删除
③编辑.git/config，将子模块相关配置节点删除
④手动删除子模块残留的目录6.子模块(submodule)操作 - 子模块实例
场景：本地已有ST项目的仓库，从远程拉取COMMON作为ST项目的子模块，更新子模块并push到远程。
①在ST项目文件夹下切换到自己的分支
②添加子模块
③查看git状态，此时ST项目文件夹下
多了两个文件/文件夹6.子模块(submodule)操作 - 子模块实例
场景：本地已有ST项目的仓库，从远程拉取COMMON作为ST项目的子模块，更新子模块并push到远程仓库。
④进入子模块文件夹
⑤切换到子模块下自己的分支
⑦查看修改后的状态
⑧提交修改
⑥修改子模块的文件6.子模块(submodule)操作 - 子模块实例
场景：本地已有ST项目的仓库，从远程拉取COMMON作为ST项目的子模块，更新子模块并push到远程仓库。
⑨push修改到远程自己的分支
之后的操作就是去Gitlab网页上发起合并分支申请，等待管理员合并子模块的代码去master分支了。
特别注意：
在主项目(ST)和子模块（COMMON）之间切换目录的时候，切换目录的同时特别要注意切换自己的分支，否
则所有的操作都跟自己的用户无关，最后的修改无效无法提交。6.子模块(submodule)操作
使用submodule注意事项：
1.对submodule做修改操作前，确保切换到正确的submodule项
目分支。因为进入submodule文件夹，分支状态还保留在父项
目的分支下。对submodule做修改前，要立即切换到
submodule下你的本地分支。
2.git pull 之后，立即执行git status，如果发现submodule有修改，
立即执行git submodule update。
3.尽量不要使用git commit -a，git add存在的意义就是让你对加
入缓存区的文件做第二次确认，而git commit -a相当于跳过了
这个确认过程。7.忽略的文件/文件夹
无须纳入Git管理的文件（通常都是些自动生成的文件，日志文件/临时文件等），可以通过创建一个名
为.gitignore的文件来管理。Git官方文档（中文）
https://git-scm.com/book/zh/v2The End