Add Google Cloud documentation

[Georgehe4]

No description provided.

[AmplabJenkins]

Can one of the admins verify this patch?

[heuermh]

Jenkins, test this please.

[heuermh]

Since this jar is in Maven Central, would --packages be more appropriate? Note also we have an issue with adam-shell that prevents using --jars (#1349).

[fnothaft]

+1 towards using --packages

[coveralls]

Coverage remained the same at 82.675% when pulling 9f3db80 on Georgehe4:google_cloud into 67890b8 on bigdatagenomics:master.

[AmplabJenkins]

Test PASSed.
Refer to this link for build results (access rights to CI server needed):
https://amplab.cs.berkeley.edu/jenkins//job/ADAM-prb/2669/
Test PASSed.

[fnothaft]

LGTM once you address @heuermh's comment RE: --packages. Thanks for the added documentation, @Georgehe4!

[Georgehe4]

Adding the dependency via --packages would be ideal except that the NIO file readers rely on Guava 20.0+.

hadoop 2.6+ breaks with guava 17.0+ (

adam/pom.xml

Line 600 in 49cbdb7

<version>16.0.1</version> <!-- note: version 17.0 breaks hadoop 2.6+ at runtime -->

)

So I am using the shaded jar is the only way to prevent naming conflicts.

I don't believe we can shade using the --packages flag, but let me know if anyone knows of a workaround.

[Georgehe4]

To clarify, the error that pops up when using --packages is: https://gist.github.com/Georgehe4/2897f2ead685a9fcf014cbf01cee4375.

Root cause:
https://stackoverflow.com/questions/45247193/nosuchmethoderror-com-google-common-base-preconditions-checkargumentzljava-lan

[Georgehe4]

Running with --jars solves the above issue:
https://gist.github.com/Georgehe4/a6ff7e37e3a8d78a3ca7dd52846bed17

[fnothaft]

Thanks for the detailed reply and gists @Georgehe4! It looks like --jars is working fine for you, that had been broken for a while earlier; apparently we fixed it without noticing it! This is good to go from my side, ping @heuermh to approve and merge.

[heuermh]

It looks like --jars is working fine for you, that had been broken for a while earlier; apparently we fixed it without noticing it

--jars works ok for adam-submit but not for adam-shell.

[heuermh]

Thank you, @Georgehe4