git工作流程(团队)

一、 前提信息 （入职时从公司获取）：

1. 获取账号和邮箱
   公司邮箱 ：http://mail.yjf.tech/sclcoder@yjf.tech/***
   GitLab 个人账号 : git.yjf.tech:sclcoder/***

二、 初始设置 (一次性设置工作)

1. 本地个人工作电脑 git 全局性配置
   git config --global user.name "sclcoder"
   git config --global user.email "sclcoder@yjf.tech"

2. 使用 GIT GUI help 菜单中 Show SSH Key 菜单项对话框按钮 Generate Key 生成一对公钥私钥；
   这一对公钥私钥用于git 命令行向gitlab服务器推送文件时使用；
   生成的公钥私钥文件保存在工作站当前用户的目录下 id_rsa 是私钥， id_rsa.pub 是公钥；

3. 将生成的SSH Key 的公钥文本添加到gitlab服务器个人用户profile中
   GitLab 上个人用户 profile中 增加一个新的 SSH Key 的路径是 : http://git.yjf.tech/profile/keys
   GitLab 上每个个人用户profile 中可以增加多个 SSH Key

三、针对每个参与的项目一次性的初始化工作（以参与的项目为 dev 组下的 aita3 为例）：

1. 登录 gitlab fork 参与的项目主库 http://git.yjf.tech/dev/aita3.git 到自己名下 (这里以名字 sclcoder 为例)，这一步骤会在自己名下生成项目，路径类似于 http://git.yjf.tech/sclcoder/aita3.git ， 其内容复制自 http://git.yjf.tech/dev/aita3.git

2. 将个人 fork 代码库克隆到个人本地工作电脑git clone http://git.yjf.tech/sclcoder/aita3.git 这一步骤会在本地当前目录创建目录 aita3，内容是 gitlab服务器上个人名下 fork库的克隆(包含所有分支)，我们称之为本地工作库

3. 本地工作电脑当前目录切换到本地工作库，并添加远程项目主库为 upstream

   cd aita3
   git remote add upstream http://git.yjf.tech/dev/aita3.git
   git remote -v  // 查看远程 源库，和 上游库信息
   

4. 本地工作电脑切换到工作分支 (如果当前默认分支已经是工作分支，则本步骤不需要,一般情况下当前默认分支是 master)
   下面假设当前默认分支是 master，但目标工作分支是 dev，所以需要将 remotes/origin/dev checkout 出来成为本地分支 dev
   git checkout -b dev remotes/origin/dev ;

四 、项目主库代码同步到本地工作库和远程fork库

1. 在需要获取主库最新代码时候从远程上游主库获取主库最新代码
   git fetch upstream // 从upstream中获取最新代码，但是不做任何合并动作，此命令不影响当前本地工作分支

2. 将拉到本地的上游库最新代码合并到本地当前工作分支

   git merge upstream/dev // 将upstream分支dev合并到本地当前分支
   

   // 注意 ： 上面命令假设本地分支为 dev 并且对应到 upstream/dev, 如果本地分支为 master 并且对应 upstream/master, 对应命令行应该为 git merge upstream/master

3. 将本地最新的代码推送到远程个人fork库
   git push

五、 个人 fork库代码同步到项目主库

一旦本地个人工作库中编辑了一些内容，经过 commit/push 到远程个人fork之后，需要将远程个人fork库代码同步到项目主库，其他人才能看到你最新的代码变化，这一目的通过在远程个人 fork 库中创建新的 merge request 并经过项目主库审批人审批通过完成；

1. 远程个人fork库中创建 merge request
   个人fork库中创建 merge request 的地址类似于 : http://git.yjf.tech/sclcoder/aita3/merge_requests

2. 将创建好的 merge request 发送给项目主库审批人
   要发送的 merge request 使用其 URL 地址形式 ： http://git.yjf.tech/dev/aita3/merge_requests/5

3. 项目主库审批人 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分支）