超详细!Github团队协做教程(Gitkraken版)

1、前期工做

 

1. 在 Github 上建立 organization

 

step1. 登陆Github网站,点击右上角头像,选择 “Settings” :html

 

step2. 选择 “Organizations” ,点击右上角 “New organization”git

 

2. 邀请队友加入 organization 并建立 team

 

step1. 进入组织,点击 “People” -> “invite member” 邀请队友加入:github

成功加入后,在 Github 我的主页的头像下方能看到本身加入的组织:浏览器

 

step2. 进入组织,点击 “Teams” -> “new team” 建立团队,而后将已加入组织的队友添加进去:fetch

 

3. 创建团队项目仓库,在设置中将 team 的权限设置为 read

 

step1. 进入组织,点击 “Repositories” -> “New” 新建团队项目仓库:网站

 

step2. 点击进入刚建立的仓库,选择 “Settings” -> “Collaborators & teams”,选择刚建的 team,将权限设置为 read:命令行

 

4. 建立开发分支,让队友 fork 到我的仓库

 

step1. 在输入框 “Find or create a branch...” 处键入dev,建立开发分支。3d

 

step2. fork 到我的仓库code

成功后在我的仓库中能看到以下 fork 信息:htm

 

2、正式使用流程(Gitkraken)

 

1. clone 项目到本地

 

点击菜单栏 “File” -> “Clone Repo”, 选择本地路径、输入本身的远程仓库 URL (如:https://github.com/thousfeet/Test),clone 完成后点击 “Open Now” 。此时左侧的 “REMOTE” 下方的 “origin” 会显示你的远程仓库信息。

操做动图:

 

2. 添加 REMOTE 关联到团队远程仓库

 

点击 “REMOTE” 右侧 “+” 号,添加团队项目仓库。此时 “REMOTE” 下会多出团队远程仓库信息。

操做动图:

 

3. 切换到 dev 分支

 

到这步,在本地仓库(左上方 LOCAL )仍只能看到 master 分支。所以在 “origin” 下的 “dev” 处点击右键 -> “check out origin/dev”,将远程的 dev 分支同步下来。

操做动图:

完成这一步以后终于能够愉快地打开本地仓库项目开始写代码辣。

 

4. 提交commit到本身的远程仓库

 

首先明确:

咱们把文件往Git版本库里添加的时候,是分两步执行的:

第一步是用git add把文件添加进去,实际上就是把文件修改添加到暂存区(stage);
第二步是用git commit提交更改,实际上就是把暂存区的全部内容提交到当前分支。

(摘自廖雪峰 Git 教程

当你修改本地仓库的文件时,Gitkraken 会自动检测到变动,并在右上角显示 “xx file changes on dev” 。点击 “Stage all changes”,将文件修改添加到暂存区,而后在最右下方的 “Commit message” 中写下 commit 信息,提交到本身的远程仓库。

操做动图:

 

5. 和团队远程保存同步

 

当你在本地修改了项目的同时,其余队友或许已在此期间给团队的仓库提交了新的代码。所以在完成了一系列 commit 将要 push 到远程以前,先要同步到与团队一致的版本,避免在 pull request 时产生冲突。

为此咱们要作两件事:更新远程仓库的代码到本地仓库(fetch),而后将内容合并到当前分支(merge)。(在合并的时候可能会出现冲突,冲突的解决方式将会在后续说明。)

在Gitkraken的操做是:在 “REMOTE” 中的团队远程仓库上单击右键 -> Fetch xxx,而后在团队远程仓库的 dev 分支上单击右键 -> Merge xxx/dev to dev 。

此时能够看到中间的树状分支图上出现了 merge 信息。

操做动图:

 

6. push 到本身的远程仓库 & 请求 pull request 到团队远程

 

点击最上方的 push 按钮将以前的一系列 commit 信息推到本身的远程仓库,而后在团队远程仓库的 dev 上右键 -> “Start a pull request to xxx/dev from origin/dev”,输入 pull request 信息(若是只有一条 commit,则会自动填充上 commit 信息),而后点击提交。此时可在右上角的弹窗单击 “View on github”,在浏览器中查看这次 pull request 。

操做动图:

 


使用 Gitkraken 进行其余 Git 操做:教程入口

包括内容:

  • 查看某次 commit 的文件改动
  • 修改 commit 信息
  • 合并屡次 commit 信息
  • 回到旧版本 commit 记录并 push 到远程仓库
  • 解决 merge 到本地时的冲突

文末致敬西瓜学长的 Github 团队协做命令行教程 ~

(补充了西瓜学长没有提到的 Organization 创建方式等)