一、 前提信息 (入职时从公司获取):
- 获取账号和邮箱
公司邮箱 :http://mail.yjf.tech/sclcoder@yjf.tech/***
GitLab 个人账号 : git.yjf.tech:sclcoder/***
二、 初始设置 (一次性设置工作)
本地个人工作电脑 git 全局性配置
git config --global user.name "sclcoder"
git config --global user.email "sclcoder@yjf.tech"使用 GIT GUI help 菜单中 Show SSH Key 菜单项对话框按钮 Generate Key 生成一对公钥私钥;
这一对公钥私钥用于git 命令行向gitlab服务器推送文件时使用;
生成的公钥私钥文件保存在工作站当前用户的目录下 id_rsa 是私钥, id_rsa.pub 是公钥;将生成的SSH Key 的公钥文本添加到gitlab服务器个人用户profile中
GitLab 上个人用户 profile中 增加一个新的 SSH Key 的路径是 : http://git.yjf.tech/profile/keys
GitLab 上每个个人用户profile 中可以增加多个 SSH Key
三、针对每个参与的项目一次性的初始化工作(以参与的项目为 dev 组下的 aita3 为例):
登录 gitlab fork 参与的项目主库 http://git.yjf.tech/dev/aita3.git 到自己名下 (这里以名字 sclcoder 为例),这一步骤会在自己名下生成项目,路径类似于 http://git.yjf.tech/sclcoder/aita3.git , 其内容复制自 http://git.yjf.tech/dev/aita3.git
将个人 fork 代码库克隆到个人本地工作电脑git clone http://git.yjf.tech/sclcoder/aita3.git 这一步骤会在本地当前目录创建目录 aita3,内容是 gitlab服务器上个人名下 fork库的克隆(包含所有分支),我们称之为本地工作库
-
本地工作电脑当前目录切换到本地工作库,并添加远程项目主库为 upstream
cd aita3 git remote add upstream http://git.yjf.tech/dev/aita3.git git remote -v // 查看远程 源库,和 上游库信息
本地工作电脑切换到工作分支 (如果当前默认分支已经是工作分支,则本步骤不需要,一般情况下当前默认分支是 master)
下面假设当前默认分支是 master,但目标工作分支是 dev,所以需要将 remotes/origin/dev checkout 出来成为本地分支 dev
git checkout -b dev remotes/origin/dev ;
四 、项目主库代码同步到本地工作库和远程fork库
在需要获取主库最新代码时候从远程上游主库获取主库最新代码
git fetch upstream // 从upstream中获取最新代码,但是不做任何合并动作,此命令不影响当前本地工作分支-
将拉到本地的上游库最新代码合并到本地当前工作分支
git merge upstream/dev // 将upstream分支dev合并到本地当前分支
// 注意 : 上面命令假设本地分支为 dev 并且对应到 upstream/dev, 如果本地分支为 master 并且对应 upstream/master, 对应命令行应该为 git merge upstream/master
将本地最新的代码推送到远程个人fork库
git push
五、 个人 fork库代码同步到项目主库
一旦本地个人工作库中编辑了一些内容,经过 commit/push 到远程个人fork之后,需要将远程个人fork库代码同步到项目主库,其他人才能看到你最新的代码变化,这一目的通过在远程个人 fork 库中创建新的 merge request 并经过项目主库审批人审批通过完成;
远程个人fork库中创建 merge request
个人fork库中创建 merge request 的地址类似于 : http://git.yjf.tech/sclcoder/aita3/merge_requests将创建好的 merge request 发送给项目主库审批人
要发送的 merge request 使用其 URL 地址形式 : http://git.yjf.tech/dev/aita3/merge_requests/5项目主库审批人 review 代码和审批 merge request
项目主库中待审批 merge request 列表的地址类似于 : http://git.yjf.tech/dev/aita3/merge_requests
如果有多个待审批 merge request 的话,审批人在这个地址可以看到各个 merge request,
点开某个 merge request (浏览器地址栏中URL类似于 : http://git.yjf.tech/dev/aita3/merge_requests/5 ) ,
可以看到 ACCEPT MERGE REQUEST 按钮,也可以进行代码 review
六、 如果远程代码库增加分支(例如backup分支),自己远程库已经fork对应的远程库代码了,也就是缺少backup分支,自己本地库也缺少backup分支,可以如下操作
git fetch upstream (远程代码库)
git checkout backup (切换本地backup分支,不存在则创建一个)
git merge upstream/backup (远程upstream合并到本地backup)
git push origin backup:backup 提交本地backup分支 作为 origin 远程的backup分支(git push origin test:master // 提交本地test分支 作为 远程的master分支)