经领导决定,代码管理平台从SVN迁移到了Gitlab,在半日时间里跌跌撞撞的摸索查询后(站在巨人的肩膀上~~),Gitlab使用流程简介如下:
一. 基本概念
1.仓库(Repository)
①源仓库(线上版本库)
在项目的开始,项目的发起者构建起一个项目的最原始的仓库,称为origin。源仓库的有两个作用:1.汇总参与该项目的各个开发者的代码;2.存放趋于稳定和可发布的代码(源仓库应该是受保护的,开发者不应该直接对其进行开发工作。只有项目管理者能对其进行较高权限的操作。)
②开发者仓库(本地仓库)
任何开发者都不会对源仓库进行直接的操作,源仓库建立以后,每个开发者需要做的事情就是把源仓库的“复制”一份,作为自己日常开发的仓库。这个复制是gitlab上面的fork。
每个开发者所fork的仓库是完全独立的,互不干扰,甚至与源仓库都无关。每个开发者仓库相当于一个源仓库实体的影像,开发者在这个影像中进行编码,提交到自己的仓库中,这样就可以轻易地实现团队成员之间的并行开发工作。而开发工作完成以后,开发者可以向源仓库
发送pull request,请求管理员把自己的代码合并到源仓库中,这样就实现了分布式开发工作和集中式的管理。
2.分支(Branch)
①master branch:主分支
master:主分支从项目一开始便存在,它用于存放经过测试,已经完全稳定代码;在项目开发以后的任何时刻当中,master存放的代码应该是可作为产品供用户使用的代码。所以,应该随时保持master仓库代码的清洁和稳定,确保入库之前是通过完全测试和代码reivew的。master分支是所有分支中最不活跃的,大概每个月或每两个月更新一次,每一次master更新的时候都应该用git打上tag,来说明产品有新版本发布。
②develop branch:开发分支
develop:开发分支,一开始从master分支中分离出来,用于开发者存放基本稳定代码。每个开发者的仓库相当于源仓库的一个镜像,每个开发者自己的仓库上也有master和develop。开发者把功能做好以后,是存放到自己的develop中,当测试完以后,可以向管理者发起一个pull request,请求把自己仓库的develop分支合并到源仓库的develop中。所有开发者开发好的功能会在源仓库的develop分支中进行汇总,当develop中的代码经过不断的测试,已经逐渐趋于稳定了,接近产品目标了。这时候,就可以把develop分支合并到master分支中,发布一个新版本。
注:正常情况下,master只应该接受develop的合并,也就是说,master所有代码更新应该源于合并develop的代码。
③feature branch:功能分支
feature:功能性分支,是用于开发项目的功能的分支,是开发者主要战斗阵地。开发者在本地仓库从develop分支分出功能分支,在该分支上进行功能的开发,开发完成以后再合并到develop分支上,这时候功能性分支已经完成任务,可以删除。功能性分支的命名一般为feature-*,*为需要开发的功能的名称。
二、如何操作(仅做举例说明用)
Step 1:源仓库的构建
这一步通常由项目发起人(项目管理员)来操作,源仓库为op/Chanjet_Asset_Management,并初始化两个分支master和develop.
Step 2:开发者fork源仓库
源仓库建立以后,每个开发就可以去复制一份源仓库到自己的gitlab账号中,然后作为自己开发所用的仓库。假设我是一个项目中的开发者,我就到op/Chanjet_Asset_Managemen项目主页上去fork.
Step 3:把自己开发者仓库clone到本地
>>> git clone http://gitlab.rd.chanjet.com/op/Chanjet_Asset_Management.git
Step 4:构建功能分支进行开发
假设现在要开发一个“讨论”功能:
>>> git checkout develop
# 切换到`develop`分支
>>> git checkout -b feature-discuss
# 分出一个功能性分支
>>> touch discuss.py
# 假装discuss.py就是我们要开发的功能
>>> git add .
>>> git commit -m 'finish discuss feature'
# 提交更改,多次测试以后
>>> git checkout develop
# 回到develop分支
>>> git merge --no-ff feature-discuss
# 把做好的功能合并到develop中
>>> git branch -d feature-discuss
# 删除功能性分支
>>> git push origin develop
# 把develop提交到自己的远程仓库中
此时,上自己gitlab的项目主页中develop分支中查看,已经有discuss.py这个文件了:
Step 5:向管理员提交pull request
在完成了“讨论”功能(当然,也可能对自己的develop进行了多次合并,完成了多个功能),经过测试以后,觉得没问题,就可以请求管理员把自己仓库的develop分支合并到源仓库的develop分支中。
Step 6 管理员测试、合并
管理员登陆gitlab,看到了开发者对源仓库发起的pull request。
管理员需要做的事情就是:
1.对开发者的代码进行review。
2.在他的本地测试新建一个测试分支,测试开发者的代码:
>>> git checkout develop
# 进入管理员本地的develop分支
>>> git checkout -b manager-develop
# 从develop分支中分出一个叫manager-develop的测试分支测试开发者的代码
>>> git pull
http://gitlab.rd.chanjet.com/op/Chanjet_Asset_Management.git develop
# 把开发者的代码pull到测试分支中,进行测试
判断是否同意合并到源仓库的develop中,如果经过测试没问题,可以把开发者的代码合并到源仓库的develop中:
>>> git checkout develop
>>> git merge --no-ff manager-develop
>>> git push origin develop
注:管理员一直在操作的仓库是源仓库。
以上,就是一个git和gitlab协同工作流的基本步骤。
Git常用操作命令收集:
1) 远程仓库相关命令
检出仓库:$ git clone git://github.com/jquery/jquery.git
查看远程仓库:$ git remote -v
添加远程仓库:$ git remote add [别名] [项目地址]
删除远程仓库:$ git remote rm [name]
修改远程仓库:$ git remote set-url --push[name][newUrl]
拉取远程仓库:$ git pull [remoteName] [localBranchName]
推送远程仓库:$ git push [remoteName] [localBranchName]
2)分支(branch)操作相关命令
查看本地分支:$ git branch
查看远程分支:$ git branch -r
创建本地分支:$ git branch [name] ----注意新分支创建后不会自动切换为当前分支
切换分支:$gitcheckout [name]
创建新分支并立即切换到新分支:$gitcheckout -b [name]
删除分支:$ git branch -d [name] ---- -d选项只能删除已经参与了合并的分支,对于未有合并的分支是无法删除的。如果想强制删除一个分支,可以使用-D选项
合并分支:$ git merge [name] ----将名称为[name]的分支与当前分支合并
创建远程分支(本地分支push到远程):$ git push origin [name]
删除远程分支:$ git push origin :heads/[name]
如果想把本地的某个分支test提交到远程仓库,并作为远程仓库的master分支,或者作为另外一个名叫test的分支,那么可以这么做。
$git push origin test:master // 提交本地test分支作为远程的master分支//好像只写这一句,远程的github就会自动创建一个test分支
3)版本(tag)操作相关命令
查看版本:$ git tag
创建版本:$ git tag [name]
删除版本:$ git tag -d [name]
查看远程版本:$ git tag -r
删除远程版本:$git push origin :refs/tags/[name]
4) 子模块(submodule)相关操作命令
添加子模块:$ git submodule add [url] [path]
如:$ git submodule add git://github.com/soberh/ui-libs.gitsrc/main/webapp/ui-libs
初始化子模块:$git submodule init ----只在首次检出仓库时运行一次就行
更新子模块:$ git submodule update ----每次更新或切换分支后都需要运行一下
删除子模块:(分4步走哦)
1)$ git rm --cached [path]
2) 编辑“.gitmodules”文件,将子模块的相关配置节点删除掉
3) 编辑“.git/config”文件,将子模块的相关配置节点删除掉
4) 手动删除子模块残留的目录
5)忽略一些文件、文件夹不提交
在仓库根目录下创建名称为“.gitignore”的文件,写入不需要的文件夹名或文件,每个元素占一行即可,如
target
bin
*.db
2.git pull:相当于是从远程获取最新版本并merge到本地
git pull origin master
https://github.com