成为 Apache 贡献者，从提交第一个简单 PR 开始！

开源之路，PR 走起 ！

                                                 ---全球最大同性交友社区

1

fork

以下实例以 incubator-dolphinscheduler 海豚调度为例进行操作

从远端仓库* https://github.com/apache/incubator-dolphinscheduler.git * fork 一份代码到自己的仓库中

注：国内用户也可以从 Gitee fork 到自己的仓库中，速度会更快一些：   https://gitee.com/dolphinscheduler/DolphinScheduler.git

2

clone

把自己仓库clone到本地

λ git clone https://github.com/xx/incubator-dolphinscheduler.git
Cloning into 'incubator-dolphinscheduler'...
remote: Enumerating objects: 304, done.
remote: Counting objects: 100% (304/304), done.
remote: Compressing objects: 100% (200/200), done.
Receiving objects: 100% (54821/54821), 152 (delta 38), pack-reused 54517 eceiving objects: 100% (54821/54821), 77.07 MiB | 918.00 KiB/s
 77.08 MiB | 463.00 KiB/s, done.
Resolving deltas: 100% (23530/23530), done.
Updating files: 100% (1557/1557), done.

3

remote

添加远端仓库地址，命名为upstream

git remote add upstream https://github.com/apache/incubator-dolphinscheduler.git

查看仓库

λ git remote -v
origin  https://github.com/xx/incubator-dolphinscheduler.git (fetch)
origin  https://github.com/xx/incubator-dolphinscheduler.git (push)
upstream        https://github.com/apache/incubator-dolphinscheduler.git (fetch)
upstream        https://github.com/apache/incubator-dolphinscheduler.git (push)

此时会有两个仓库：origin(自己的仓库)和upstream（远端仓库）

4

branch

查看分支

λ git branch -v
  dev                         d70d8a60 [Feature-3222][datasource] Store password in ciphertext instead  (#3330)

创建分支

λ git checkout -b dev-local
Switched to a new branch 'dev-local'

dev-local 用于本地测试、开发

在提交PR之前，需要创建一个分支专门用作此次PR代码分支，等待合并到原远端仓库后，可删除分支。

git checkout dev

dev-imp-server-ProcessUtils-temp 用于解决代码冲突

dev-imp-server-ProcessUtils 用于提交PR 的代码分支

D:\developer\git-repository\incubator-dolphinscheduler (dev-imp-server-ProcessUtils)
λ git add .
D:\developer\git-repository\incubator-dolphinscheduler (dev-imp-server-ProcessUtils)
λ git commit -m "server model ProcessUtils.java code cleaning." .
[dev-imp-server-ProcessUtils 69ba65db] server model ProcessUtils.java code cleaning.
 1 file changed, 6 insertions(+), 16 deletions(-)
D:\developer\git-repository\incubator-dolphinscheduler (dev-imp-server-ProcessUtils)
λ git push origin dev-imp-server-ProcessUtils

5

pull request

登录github.com 在自己仓库下，如果有更改的分支，系统会有提示栏，也可以通过点击 Pull request栏new pull request.

需要填写对本次RR的一个描述，目的，变更日志等。在网页下面也可以看见本次PR提交的代码变更。本次实例只是做了一些代码清理，清理不在引用的变量和清理不需要上抛的异常类型。

提交之后，接着社区Committer们会做CodeReview，然后他会与您讨论一些细节（包括设计，实现，性能等）。当团队中所有人员对本次修改满意后，会将提交合并到dev分支。

6

同步

如何保持和原远端仓库同步？？？

获取/更新远端仓库代码

git fetch upstream
From https://github.com/apache/incubator-dolphinscheduler
 * [new branch]        1.2.0-release       -> upstream/1.2.0-release
 * [new branch]        1.2.1-release       -> upstream/1.2.1-release
 * [new branch]        1.3.1-release       -> upstream/1.3.1-release
 * [new branch]        1.3.2-release       -> upstream/1.3.2-release
 * [new branch]        alert_plugin_design -> upstream/alert_plugin_design
 * [new branch]        bcai-upgrade-java-version-for-sonarcloud -> upstream/bcai-upgrade-java-version-for-sonarcloud
 * [new branch]        dev                 -> upstream/dev
 * [new branch]        dev-1.3.0           -> upstream/dev-1.3.0
 * [new branch]        master              -> upstream/master
 * [new branch]        proposal            -> upstream/proposal

切换到dev分支

git checkout dev

同步远端仓库dev分支代码到本地仓库dev分支

git merge upstream/dev

提交到自己仓库

git push origin dev

7

贡献第一个 PR

参与 DolphinScheduler 社区有非常多的参与贡献的方式，包括文档、翻译、布道、答疑、测试、以及代码等，此外也极其欢迎各种实践文章，文章内容包含不限于：DS 部署，使用，经验分享，故障处理，源码分析等。DolphinScheduler开源社区非常期待您的参与。

DolphinScheduler 社区参与贡献的方式，包括：

贡献第一个PR(文档、代码) 我们也希望是简单的，第一个 PR 的主要作用是熟悉社区协作流程及感受社区友好度，这个 PR 可以是为文档补充 1、2句话，给代码添加 1、2 行注释等等都行，你说简单不简单？

如何参与贡献链接：https://dolphinscheduler.apache.org/zh-cn/docs/development/contribute.html

文档 github 地址：https://github.com/apache/incubator-dolphinscheduler-website

来吧，DolphinScheduler开源社区需要您的参与，为中国开源崛起添砖加瓦吧，哪怕只是小小的一块瓦，汇聚起来的力量也是巨大的

 

小彩蛋

贡献完 一个 PR 后，将邀请加入 DolphinScheduler 的开发者群，享有生产环境若遇到问题优先处理的福利吆

 

如果以上文章看不大懂，也不要紧，DolphinScheduler有开发者种子群，会培养如何提交自己的第一个 PR ，只要你是想为开源做贡献，欢迎联系

1、DolphinScheduler 社区是非常 open 的，有啥问题都可以随时直接开聊哈/::D

2、参与代码贡献的话，大家可以先尝试在自己本地搭建一下开发环境哈，https://dolphinscheduler.apache.org/zh-cn/docs/development/development-environment-setup.html 按照这个文章，遇到问题欢迎群里直接聊下，必要的话远程看看啥情况

3、当然参与 DolphinScheduler 社区有非常多的参与贡献的方式，包括文档、翻译、布道、答疑、测试、以及代码等，此外也极其欢迎各种实践文章，文章内容包含不限于：DS 部署，使用，经验分享，故障处理，源码分析等等。有意参与非代码贡献的伙伴欢迎群里聊起

4、贡献第一个 PR (文档/文章、代码) 我们也希望是简单的，第一个 PR 的主要作用是熟悉社区协作流程及感受社区友好度，这个 PR 可以是为文档补充 1、2句话，给代码添加 1、2 行注释等等都行