美文网首页工具使用@IT·互联网程序员
使用GitHub构建自己的远程代码库

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

作者: 周PI君 | 来源:发表于2016-02-04 12:43 被阅读2240次

     背景


    存在这样一种状况,工作的时候有一个模块因为思路阻塞不能前进,周末在家忽然有了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分支需要多个人协作,怎么办呢?这不是本片内容的范畴,如果有疑惑后续发文再聊啦~

    相关文章

      网友评论

      • 2047010cb96a:一直想学
      • 10226f612535:我去试试
      • letcoda:git分支这一块不太熟,留下学了
      • 先生null:不太会用,学习了
      • d018164ba4e6:多谢作者分享。
      • 狂暴的小牛:技术活
      • 0170fb08aebd:所以这就是个github新手指南:sweat:你工作代码如果也用git那你在家commit在本地不就完事了,到公司再push ,如果有vpn 就更好,可以直接工作。而且最要命的是,你公司的代码就被你放上去开源了…还是说你花钱了:cold_sweat:,要是这样你还不如用gitbucket 呢。
        0170fb08aebd:@周PI君 :+1:
        周PI君:@柴柴LOL 同意你的观点!首先,这是个新手贴~对于git基础操作的介绍~其次,公司的代码不建议这么干,至于什么可以放,什么不能放,自己决定,不给建议~
      • 笑吧小鸟:推荐coding速度快
        周PI君:@笑吧小鸟 git在上传远仓库时的速度确实慢~ 谢谢推荐~
      • 刘黄雅各:有用,收了细看

      本文标题:使用GitHub构建自己的远程代码库

      本文链接:https://www.haomeiwen.com/subject/icpekttx.html