工具使用@IT·互联网程序员

使用GitHub构建自己的远程代码库

2016-02-04  本文已影响2240人  周PI君

 背景


存在这样一种状况,工作的时候有一个模块因为思路阻塞不能前进,周末在家忽然有了idea,但是手头没有模块Code,只能动笔记下思路,周一上班Code实现。这种状况对于Coder而言比较频繁,相比用笔写下思路,Coder们更希望可以直接在代码中调试解决,这样在遇到新的问题,才有实际的依据继续深入,毕竟多数的Idea没有Code的支持,很难言其靠谱性。

当然,你也可以常备U盘,时时更新,如果考虑保密等问题,确实应该,如果只是纯技术,其实有更好的解决办法——代码版本管理工具。

这类工具,PI君用过SVN和GIt,至于TFS,闻过大名,限于单位性质,不曾采用。如果只是构建自己的远程代码库,考虑到Github的免费空间,PI君推荐使用Git,简单易用。

git

总体思路


设计思路

需求描述:

→在家或者在单位都可以获取某个项目或模块的最新Code;

→可以将本地所做的修改上传至Github远程仓库;

→可以控制版本的发布,对发布版本有独立的路径进行访问;

→可以在不影响当前功能的基础上独立开发新功能,并允许最终合并至Develop版本;

→可以追踪历史版本,对每一个历史版本有文档记录。

OK,就PI君自己,以上所列基本满足需求了。当然,Git本身,在满足以上需求的同时,还具备其他的功能,感兴趣的看官们自行挖掘吧~别忘了有好的分享也知会下PI君~~

实施过程


下载安装git

首先,当然是下载安装Git啦

Git官网下载地址:https://git-scm.com/downloads

配置github远程仓库

其次,配置下Github远程仓库,过程不细说,申请github账号->新建Repository,最后结果如下图:

new Repository

一般的有关github的使用说明,到此就结束了,但是就PI君篇头所提的需求,目前还不满足。还需要针对这个空的github的Repository做一些配置。

配置github的Repository

新建的Repository默认master为其主干分支,我们要做的是另建一个分支Develop,如下图:

新建Develop分支

这个分支用来做什么的呢?且看我们的需求:

可以控制版本的发布,对发布版本有独立的路径进行访问;

当前的Repository有两个分支:master和Develop,这样,PI君可以把本地新增代码只上传到Develop分支,一旦完成一个版本,就可以将该版本合并至master,如果不需要发布新版本,那么所有的代码更新只在Develop分支上发生,这样,PI君就可以控制版本的发布啦。

配置本地Git

首先,先安装git,window版本有安装向导,一路next即可,Linux版本也有很多教程,这里不再赘述。

选一个路径,新建文件夹,取名“TestGit”,在VS里新建一个用于测试Git的工程项目,路径配置在刚才新建的文件夹,(项目类型whatever,啥项目都行)。OK,在TestGit文件夹下右键选择“Git Bash Here”,弹出Git bash命令行,如下图:

gitbash

首先,需要生成本地SSH-KEY,并添加至Github中,这是一个通行证,gitgub必须知道是谁在某个特定账户推送更新,如果没有key的限制,大家都可以更改PI君的github代码,不可想象~,很简单,在gitBash中输入:

ssh-keygen -t rsa -C "你的github注册邮箱"

这样会默认在本地用户文件夹下产生两个文件:

SSH-KEY文件

这个是你本地的SSH密钥,如果想在本地更新那个github代码仓库,必须把你本地的publickey添加至github账户的SSH-KEY列表中,拿PI君自己举例:

首先,使用txt打开id_rsa.pub文件,复制里面的全部内容,然后打开github账户设置,见下图:

github-Setting

找到SSH Keys,点开,然后点击【New SSH key】,如下图:

New SSH key

起个名字给Title,在Key中粘贴复制的内容,点击Add SSH key,添加完成。

现在本地就可以向github远程仓库推送更新了。

本地git使用策略

在配置完远程仓库和本地git连接后,剩下的就是怎么使用远程仓库以及本地git来实现剩下的需求啦,我们回顾一下一开始的需求:

→在家或者在单位都可以获取某个项目或模块的最新Code;

→可以将本地所做的修改上传至Github远程仓库;

→可以控制版本的发布,对发布版本有独立的路径进行访问;

→可以在不影响当前功能的基础上独立开发新功能,并允许最终合并至Develop版本;

→可以追踪历史版本,对每一个历史版本有文档记录。

OK,这些需求的最终实现,需要git的本地使用策略来完成~

首先,初始化本地仓库(可以在新建的空文件夹或已有文件的文件夹,反正不限制):

$git init

然后,添加远程主机(github仓库):

$git remote add <远程主机名> <远程主机地址>

例如:

$git remote add github_footballgame https://github.com/fei090620/FootballGame.git

将远程仓库复制到本地(如果远程仓库是新建的,那这一步可以省了):

$git clone <远程仓库地址>

例如:

$git clone https://github.com/fei090620/FootballGame.git

此时,会在TestGit文件夹下生成一个FootballGame的新文件夹,里面包含了FootballGame这个Repository里所有数据。

推送本地仓库的内容至远程

$git push -u origin master

加上参数“-u”,Git不但会把本地的master分支内容推送的远程新的master分支,还会把本地的master分支和远程的master分支关联起来,在以后的推送或者拉取时就可以简化命令。

推送成功后,可以立刻在GitHub页面中看到远程库的内容已经和本地一模一样。如果出现SSH警告,可以无视。后续所有本地仓库在master上的更新都可以push至github仓库下的master分支啦~~~

远程master,也就是origin/master和本地的master分支默认对应,推送的时候,如果不加更改,也是本地master和origin/master分支关联,如果,我们想推送Develop分支怎么办?

毕竟,考虑控制发布发布的需求,master分支中的版本是Develop版本更新到一定程度的时候对外发布至master,所以,频繁被推送的远程分支应该是origin/Develop,而不是origin/master。要达到这个目的,必须做一些修改:

首先,在本地git仓库新建一个计划和origin/Develop分支关联的分支,这是除master主分支以外的另一个比较重要的分支,可以自定义取名,方便理解,取相同的名字“Develop”。

$git branch Develop  //新建Develop分支

$git checkout Develop  //切换至Develop分支

#当然也可以一步到位

$git checkout -b Develop

制定本地Develop分支与远程origin/Develop分支连接:

$git branch --set -upstream Develop origion/Develop

然后,先pull,然后合并无冲突后,再push,这是原则,奉劝看官们不要违背,至于为什么,用过svn的应该能理解,PI君就不废话了。

$git pull

$git push origin/Develop

这样,本地Develop就可以推送至远程仓库中的Develop分支。

那如果,想发布了呢,简单,现在本地仓库里合并至master分支,然后推送至origin/master即可,操作如下:

$git status //检查下当前工作空间的更新情况

$git checkout master //切换至master

$git merge Develop //合并Develop至master

$git pull //获取origin上的最新版本

$git push origin master //推送当前分支至origin/master分支

OK,到此,需求已经基本满足了,那如果本地master分支或者Develop分支需要多个人协作,怎么办呢?这不是本片内容的范畴,如果有疑惑后续发文再聊啦~

上一篇下一篇

猜你喜欢

热点阅读