贡献hadoop patch

scaoping

　　转自: http://yuntai.1kapp.com/?p=621
　　

　　Apache对它的项目开放了一个Jira平台，任何人都可以在Apache Jira中查找该平台记录的一些bug获取其他问题，如果要创建或者评论，就需要创建相应的账户。
　　平时使用apache的项目的时候可能会发现一些存在的bug，这些bug或许在Apache Jira中已经存在，或许在Apache Jira已经解决，也可能在Apache Jira中没有该bug，作为一个开发者，发现问题bug、解决bug是很平常的事，但是有没有想过将发现的bug提交给Apache，或者将解决bug的代码提交给Apache？或许你提交的bug在下一个版本中得到了解决，或许你提交的patch出现在了下一个版本的源代码中。
　　提交bug比较简单，在这里就不详述了，值得注意的是，提交bug会生成相应的编号，这个编号可以很方便的寻找该bug。
　　下面是如何生成patch文件以及提交patch。
　　1、首先是选择hadoop版本，从svn中下载该版本hadoop源代码；
　　2、源代码下载完成后，将源代码做一个备份，如原版为hadoop，备份版为hadoop-bak，用来测试patch；
　　3、修改源代码目录下的代码，直接将解决bug的代码改到源码目录下对应的文件，同时需要增加相应的单元测试代码；
　　4、修改完成后则是开始生成patch文件，在hadoop目录下使用下面的命令：
　　svn diff > /path/to/文件名
　　patch的名字建议使用bug编号的名字，例如bug是HDFS-11111，则patch名字建议为HDFS-11111.patch，patch文件不要放在hadoop-bak目录中。
　　生成的patch格式如下：
　　Index: hadoop-common-project/hadoop-common/src/test/java/org/apache/hadoop/fs/TestFileSystemCaching.java
　　===================================================================
　　— hadoop-common-project/hadoop-common/src/test/java/org/apache/hadoop/fs/TestFileSystemCaching.java (revision 1421644)
　　+++ hadoop-common-project/hadoop-common/src/test/java/org/apache/hadoop/fs/TestFileSystemCaching.java (working copy)
　　@@ -48,7 +48,41 @@
　　FileSystem fs2 = FileSystem.get(new URI(“cachedfile://a”), conf);
　　assertSame(fs1, fs2);
　　}
　　+ @Test
　　+ public void testCacheGet() throws Exception {
　　+ FileSystem.setCreateFileSystemNum();
　　+ CreateFileSystem[] createFileSystem = new CreateFileSystem[10];
　　+ for (int i = 0; i < 5; i++) {
　　+ createFileSystem = new CreateFileSystem();
　　+ Thread thread = new Thread(createFileSystem);
　　+ thread.start();
　　+ thread.join();
　　+ }
　　+ }
　　5、生成patch文件后需要进行测试，在hadoop-2.0.2的版本中有test-patch.sh脚本，进入hadoop-bak目录，
　　执行dev-support/test-patch.sh /path/to/patch
　　会对将patch应用到的hadoop-bak的源代码中，然后进行编译测试，如果期间没有错误输出，则可以将patch提交到Jira中，再由Jira的机器人去执行验证，最后由管理员处理。