怎么用apache flink开发一个issue

fork代码

首先我们要有一个自己的github账号，我们需要把flink的代码fork到自己的账号下，打开https://github.com/apache/flink，点击这个fork按钮，之后我们就会在我们自己的账号下看到相应的工程了。

下载到本地

之后我们就可以把刚才fork的flink的代码下载到我们的本地，可以用下面的命令:

cd my_workspace  
git clone  https://github.com/zhangjun0x01/flink.git

添加远程仓库

接下来我们添加一个apache的远程仓库，主要是为了后期更新代码。

git remote add apache https://github.com/apache/flink.git

之后执行查询远程仓库命令git remote -v，可以看到有两个远程仓库。

origin https://github.com/zhangjun0x01/flink.git (fetch)
origin https://github.com/zhangjun0x01/flink.git (push)
apache https://github.com/apache/flink.git (fetch)
apache https://github.com/apache/flink.git (push)

添加新分支

接下来，添加一个新分支，用于开发我们的代码。分支的名字可以自己随便起，比如为了方便区分和查询，我们可以起一个和这issue同名的分支名，或者根据功能起一个自己好识别的分支名.

我这个是我起了一个和这个功能相关的分支名.

https://github.com/zhangjun0x01/flink/tree/flink-orc-input

然后我们现在就可以在这个分支上开发自己的代码了，开发完代码之后，我们需要检查一下代码的规范，这个也就是checkstyle

写测试代码

最后开发完了相关的代码之后，需要在相关的测试类里面添加相应的测试代码，如果添加一个新功能，还需要添加相应的文档。

提交代码

我们开发完了代码之后，这段时间可能flink的主分支已经有了代码的更新，所以我们为了避免冲突，还需要把最新的代码更新下来。首先切换到主分支

git checkout master 
git pull apache master

之后，我们切换到我们的分支：

# 切换到自己的分支
git checkout flink-orc-input
# 添加刚才改动的代码，如果不确定改了哪些，可以git status看一下
git add your_code 
git commit -m '注释'
# 把变化的代码添加到我们的分支
git rebase
# 提交分支到自己的仓库
git push origin flink-orc-input  
  

提交到社区

我们提交分支之后，就可以提交相应的PR（Pull Request）了，比如我的这个PR：https://github.com/apache/flink/pull/11434 。提交的时候注意标题要写成 [ISSUE] + title的形式，比如 [FLINK-16646] [orc] Flink read orc file ......    这样的话就能把你这个pr和issue自动关联上。

之后我们就能在相应的issue页面看到关联的PR

合并PR

你的代码提交完之后，之后会有相关的committer或者其他人帮你review代码，当然你也能帮别人review代码，这个也是你贡献社区的一种方式。

如果committer认同了你的改动，然后他就会把你的改动合并到master分支，或者是其他相应的分支。

比如我这个，不仅仅是改了master，还改了1.10分支，所以这里有两个关联的PR。