热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

如何往gitlab/github上游贡献代码

Git是一个开源的分布式版本控制系统,它能够记录每一次改动。一些概念仓库:git中以仓库为单位;每个项目对应一个仓库,如eayuntestRally、eayunteststack

Git 是一个开源的分布式版本控制系统,它能够记录每一次改动。

一些概念

仓库:git 中以仓库为单位;每个项目对应一个仓库,如 /eayuntest/Rally、/eayuntest/stack 是 eayuntest 下的两个不同的仓库;
分支:git 中可以建不同的分支,但一般会有一个主分支,默认是 master,使用 git 时一般是在各个分支上进行开发,最终合并到主分支上;
上游:没有确切的定义,可以理解为某一个项目的公共仓库,大家都要向这个仓库贡献代码,那么就要将这个仓库作为各自的上游

至少要学会使用的几个 Git 命令

git clone

将一个仓库克隆到某个目录。更多可以参考 man git-clone。

举个栗子:

# git clone ssh://git@10.10.10.170:2222/lhx/test.git
Cloning into 'test'...
warning: You appear to have cloned an empty repository.

git status

查看当前 git 的状态,可以知道目前在哪个分支上、是否有改动等。更多可以参考 man git-status。

继续举个栗子:

# git status
# On branch master
#
# Initial commit
#
nothing to commit (create/copy files and use "git add" to track)

git add

将改动添加到 git 缓存区。更多可以参考 man git-add。

还要举个栗子:

# echo 'I am a test repo' >> README.md
# git add README.md
# git status
# On branch master
#
# Initial commit
#
# Changes to be committed:
#   (use "git rm --cached ..." to unstage)
#
#       new file:   README.md
#

git commit

上面 git add 只是将改动添加到缓存区,并没有真正的提交,仍然可以随意改动。git commit 将改动提交,并记录改动的提交信息。更多可以参考 man git-commit。

依旧举个栗子:

# git commit -s 

*** Please tell me who you are.

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'root@coffee-rally.(none)')

# git config user.email 'xxxx@eayun.com'
# git config user.name 'xxxx'

# git commit -s
[master (root-commit) 30454ce] Add README.md
 1 file changed, 1 insertion(+)
 create mode 100644 README.md

git push

上面的 git commit 提交,只是在本地进行了提交,还需要推送到远程的仓库中,因此需要 git push 来完成。更多可以参考 man git-push。

再来举个栗子:

# git push origin master
Counting objects: 3, done.
Writing objects: 100% (3/3), 254 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To ssh://git@10.10.10.170:2222/lhx/test.git
 * [new branch]      master -> master
到这里,对一个仓库进行提交的工作已经完成。但是,由于 git 是分布式的,你本地的内容和远程的内容并不一定是一致的,因此你还需要去同步远程仓库的内容,这就是下面几个命令可以完成的工作。

git fetch

下载远程分支的内容,但没有合并到本地分支中。更多可以参考 man git-fetch。

还是举个栗子:

# 远程的仓库做了一些改动,与我本地不一致,我要把它们下载下来:
# git fetch origin master
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From ssh://10.10.10.170:2222/lhx/test
 * branch            master     -> FETCH_HEAD

git merge

上面也说过,git fetch 只是下载内容,没有做合并,所以我们需要合并它们。

只能举个栗子:

# 就是将远程的分支,合并到本地分支:git merge [remote_branch] [local_branch]
# git merge origin/master master
Updating 875d8e2..a2fb8ab
Fast-forward
 README.md | 2 ++
 1 file changed, 2 insertions(+)

git pull

其实 git pull = git fetch + git merge,平时只在把远程分支合并的时候用到。不过查到有说要少用 git pull,原因在这里: Git 少用 Pull 多用 Fetch 和 Merge,其实这是翻译成中文的,有兴趣可以看英文版: GIT: FETCH AND MERGE, DON’T PULL

又要举个栗子:

# 对于上面的改动,如果直接用 git pull 的话,是这样:

# git pull
remote: Counting objects: 3, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From ssh://10.10.10.170:2222/lhx/test
   875d8e2..a2fb8ab  master     -> origin/master
Updating 875d8e2..a2fb8ab
Fast-forward
 README.md | 2 ++
 1 file changed, 2 insertions(+)

git checkout

之前也介绍了,在 git 里面有分支的概念,那么怎么切换不同的分支呢?git checkout 就登场了。

也是举个栗子:

# 如果切换到某个已存在的分支:
# git checkout xxx
Switched to branch 'xxx'

# 如果分支不存在呢?那要切换过去,并且新建分支:
# git checkout -b coffee
Switched to a new branch 'coffee'
重要提示:开发过程中,要注意基于 master 分支去建新的分支,这样才能保证是在 master 的基础上进行的开发,不会有多余的内容提交。

git branch

分支相关操作的命令,可以列出、创建、删除分支,它与 git checkout -b 的区别就是,它新建了分支之后,不会切换过去。

惯例举个栗子:

# 列出分支:
# git branch -l
* coffee
  master
  test
# 列出所有分支:
# git branch -a
* coffee
  master
  test
  remotes/origin/HEAD -> origin/master
  remotes/origin/master
# 新建分支:
# git branch [branch_name]
# 删除分支:
# git branch -d test
Deleted branch test (was a2fb8ab).

如何提交pull request

举例一个场景:eayuntest 里有一个项目叫:Rally,我要为这个项目贡献代码。

在这里,/eayuntest/Rally 对我来说,是上游,是公共的代码,我是不能随意改动的

因此,我需要做的第一步,就是将上游的代码 Fork 到我的名下,像这样,点击fork:

fork后会在生成一个自己名下的库,比如:

现在,/eayuntest/Rally 就是我的上游,/lhx/Rally 就是我的仓库,我对 /lhx/Rally 随意做改动,都不会影响到 /eayuntest/Rally,那么,我们的首要目的已经达到了。

接下来,把 /lhx/Rally 克隆到本地,新建一个开发分支,不能在 master 上直接进行开发,因为 master 永远是跟上游同步的,我们也不能对它进行修改,否则同步就会出错。

# git branch -l
  eayunstack-master
* lhx_rebuild_0904

某个功能的代码提交后,就可以去提 pull request 了:

编写 pull request 的信息后,可以点击提交:

这里,跳转到了上游的界面,reviewer 审查代码通过后,就可以把这个 pull request 合并到上游的 master 分支上:

到这里,提交 pull request 的工作已经完成了,就可以等着被 merge (接受了该提交)或者被 close(没有接受该提交)了。

但是,又要说一次,git 是分布式的嘛!如果你有一天发现,诶?上游更新了,我的代码跟上游不一样了,怎么办?

请继续往下看,我们要做同步的操作:

如何同步一个上游的 Fork

首先,虽然 fork 之后,/eayuntest/Rally 就是我的上游,但在本地仓库中,并不知道“上游”是什么,所以第一步,你要告诉你本地的仓库,你的上游是什么。

先看看目前我们跟踪的是什么仓库:

# git remote -v 
origin  ssh://git@175.25.23.162:10694/CoffeeChou/Rally.git (fetch)
origin  ssh://git@175.25.23.162:10694/CoffeeChou/Rally.git (push)
目前只是跟踪了自己的仓库,这个仓库名称叫 origin(默认的),那么我们要把上游仓库加进来,起名字叫 upstream(惯例):

# git remote add upstream ssh://git@175.25.23.162:10694/eayuntest/Rally.git
这个时候再看我们所跟踪的仓库,就可以看到有上游了:

# git remote -v 
origin  ssh://git@175.25.23.162:10694/CoffeeChou/Rally.git (fetch)
origin  ssh://git@175.25.23.162:10694/CoffeeChou/Rally.git (push)
upstream        ssh://git@175.25.23.162:10694/eayuntest/Rally.git (fetch)
upstream        ssh://git@175.25.23.162:10694/eayuntest/Rally.git (push)
当我们需要去同步上游时(一般是同步上游的 master,即我们为哪个分支做贡献),就用到前面说的命令:

要下载上游的内容到本地:

# git fetch upstream eayunstack-master
remote: Counting objects: 1, done.
Unpacking objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0)
From ssh://175.25.23.162:10694/eayuntest/Rally
 * branch            eayunstack-master -> FETCH_HEAD
说明一下,因为我是为上游 /eayuntest/Rally 的 eayunstack-master 贡献代码,所以我要同步的是这个分支的内容到我的 master 上。

合并之前,要确保自己在 master 分支上(我没有试过不在 master 上合并会怎么样,不过应该只要指定了合并的目的分支,应该不会有问题,保险的话还是切换吧),因为我们这里的 master 分支其实是 eayunstack-master,所以:

# git checkout eayunstack-master
Switched to branch 'eayunstack-master'

合并上游分支到本地分支:

# git merge upstream/eayunstack-master eayunstack-master
Updating 92266e9..0fde160
... ...

这个时候,可以看到有合并过来的提交,并没有被推送到远程的 /lhx/Rally 上:

# git status
# On branch eayunstack-master
# Your branch is ahead of 'origin/eayunstack-master' by 35 commits.
#   (use "git push" to publish your local commits)
#
nothing to commit, working directory clean

那么,最后,就只要将这些合并过来的提交推送到 /lhx/Rally 上就可以了:

# git push origin eayunstack-master
Total 0 (delta 0), reused 0 (delta 0)
To ssh://git@175.25.23.162:10694/lhx/Rally.git
   92266e9..0fde160  eayunstack-master -> eayunstack-master

今天在上传代码时遇到一个问题,github网页显示上传的文件夹是置灰状态无法查看文件,上网查询才知道是文件夹中存在另一个.git,解决方法如下:

进入库目录,删除库缓存:
git rm -r --cached <出现问题的库文件路径>

删除后重新执行git add、git commit、git push操作,刷新网页就ok啦~~


推荐阅读
  • 从 .NET 转 Java 的自学之路:IO 流基础篇
    本文详细介绍了 Java 中的 IO 流,包括字节流和字符流的基本概念及其操作方式。探讨了如何处理不同类型的文件数据,并结合编码机制确保字符数据的正确读写。同时,文中还涵盖了装饰设计模式的应用,以及多种常见的 IO 操作实例。 ... [详细]
  • 深入解析Java虚拟机(JVM)架构与原理
    本文旨在为读者提供对Java虚拟机(JVM)的全面理解,涵盖其主要组成部分、工作原理及其在不同平台上的实现。通过详细探讨JVM的结构和内部机制,帮助开发者更好地掌握Java编程的核心技术。 ... [详细]
  • 本文将介绍如何编写一些有趣的VBScript脚本,这些脚本可以在朋友之间进行无害的恶作剧。通过简单的代码示例,帮助您了解VBScript的基本语法和功能。 ... [详细]
  • 本文详细介绍了Java编程语言中的核心概念和常见面试问题,包括集合类、数据结构、线程处理、Java虚拟机(JVM)、HTTP协议以及Git操作等方面的内容。通过深入分析每个主题,帮助读者更好地理解Java的关键特性和最佳实践。 ... [详细]
  • 深入解析Java枚举及其高级特性
    本文详细介绍了Java枚举的概念、语法、使用规则和应用场景,并探讨了其在实际编程中的高级应用。所有相关内容已收录于GitHub仓库[JavaLearningmanual](https://github.com/Ziphtracks/JavaLearningmanual),欢迎Star并持续关注。 ... [详细]
  • Java 架构:深入理解 JDK 动态代理机制
    代理模式是 Java 中常用的设计模式之一,其核心在于代理类与委托类共享相同的接口。代理类主要用于为委托类提供预处理、过滤、转发及后处理等功能,以增强或改变原有功能的行为。 ... [详细]
  • Linux环境下Git安装及常见问题解析
    本文详细介绍了在Ubuntu系统中安装Git的过程,包括环境检查、软件安装、用户配置以及SSH密钥生成等步骤,并针对安装过程中可能出现的问题提供了有效的解决方案。 ... [详细]
  • 在尝试用另一台电脑的MySQL文件替换本地D:\xampp\mysql目录后,MySQL服务无法启动。错误提示显示MySQL意外关闭,可能是由于端口冲突、依赖缺失、权限问题或崩溃等原因引起。 ... [详细]
  • 20100423:Fixes:更新批处理,以兼容WIN7。第一次系统地玩QT,于是诞生了此预备式:【QT版本4.6.0&#x ... [详细]
  • 本文探讨了在 OpenStack 环境中使用虚拟机部署 Ceph 集群后,外部服务器通过浮动 IP 无法访问该集群的问题,并提供了详细的解决方案。 ... [详细]
  • 在成功安装和测试MySQL及Apache之后,接下来的步骤是安装PHP。为了确保安全性和配置的一致性,建议在安装PHP前先停止MySQL和Apache服务,并将MySQL集成到PHP中。 ... [详细]
  • 对象自省自省在计算机编程领域里,是指在运行时判断一个对象的类型和能力。dir能够返回一个列表,列举了一个对象所拥有的属性和方法。my_list[ ... [详细]
  • 本文详细探讨了JavaScript中的作用域链和闭包机制,解释了它们的工作原理及其在实际编程中的应用。通过具体的代码示例,帮助读者更好地理解和掌握这些概念。 ... [详细]
  • ------------------------------————————————————————————————1.定义一个类,实现与被增强对象相同的接口2.在类中定义一个对象,记住被增强 ... [详细]
  • 本文介绍了如何在 C# 和 XNA 框架中实现一个自定义的 3x3 矩阵类(MMatrix33),旨在深入理解矩阵运算及其应用场景。该类参考了 AS3 Starling 和其他相关资源,以确保算法的准确性和高效性。 ... [详细]
author-avatar
个信2602907025
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有