《PolarDB for PostgreSQL源码与应用实战》——如何参与贡献PolarDB for PostgreSQL开源(中) https://developer.aliyun.com/article/1232497?spm=a2c6h.13148508.setting.19.5e4f4f0ecmbIFO
开发示例
下面将简单用一个实例验证,告诉大家如何快速加入到我们的开源项目中。
我们通过git clone那个项目代码,这里已经gitclone好了,可以看一眼gitlog,看到已经更新到最新的位置信息了。
下面是我们刚才讲到的提供了一个docker的快速启动方式。
比如build出一个docker版本,我们可以通过这个命令,比如这个命令可以用社区提供的dockerfile去创建。
创建以后我们可以看到这个Images。
可以看到生成好的一个Image,通过Image就可以直接启动集群。
我们需要把它停下来,去启动我们的集群。通过我exec命令登记到集群里边,进来以后可以看到代码已经给它git clone下来了。我们可以尝试看一下build.sh。
可以看到是下图这样,但是我们看到没有语法高亮,尝试一下用vim去看一下语法高亮。
没有提供我们的vim,就需要去装一个。如果发现没有装,我们是否可以让社区版自己提供vim,这样下次使用的时候就可以不用自己安装了,这就是我们修改贡献开源的一个好处。
装好以后,我们就可以看到高亮了。
这个改进是否可以直接把它作为代码提交到开源社区,答案是当然可以,这里边已验证了,通过安装vim就可以了。我们转到docker目录。
Docker目录里,我们打开了dockerfile,可以在这里进行安装,比如加一个vim。
我们去验证一下这个改进是否可以。
如上所示,这样就可以了。
我们重新拉起了一个,登进来以后看一下是否直接就可以进行一个vim。
出现上图则说明我们这个功能是ok的,可以把这个代码进行提交。
进行代码提交的时候,首先给它一个新的branch,比如叫fix_dockerfile,然后给它checkout fix_dockerfile,可以看一下是在哪个分支上。
这个时候我们可以看到更改这个文件已经可以了,这里还有更改历史。
可以看到我们的提交已经完成了。
那怎么把我们的提交推到社区呢?提交前需要git check到master。
接着需要更新一下代码,更新了代码以后要checkout fix_dockerfile,我然后再rebase master就可以提交了。
这样我们就把代码提交到社区了,之后可以看一眼我们的代码。
我们可以通过建一个pull request,然后Comepare pull request。
然后可以看到docker file,描述一下这是一个什么提交。
然后通过create poll request就可以把我们的代码快速提到master分支里,到这整个代码提交流程包括修改流程就基本完成了。
这里我把命令列出来,大家可以参考一下
下面是一些git的命令。
最后,欢迎大家一起加入到我们的开源项目中,贡献一份力量,提出一些想法,让我们一起努力,把这个项目做大做强。