Dear Wiki user, You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.
The "HowToRelease" page has been changed by SomeOtherAccount: https://wiki.apache.org/hadoop/HowToRelease?action=diff&rev1=83&rev2=84 ## page was copied from HowToReleasePostMavenization ''This page is prepared for Hadoop Core committers. You need committer rights to create a new Hadoop Core release.'' - These instructions have been updated to use dev-support/bin/create-release. Earlier versions of this document are at HowToReleaseWithSvnAndAnt and HowToReleasePostMavenization and HowToReleasePreDSBCR + These instructions have been updated to use dev-support/bin/create-release. Earlier versions of this document are at HowToReleaseWithSvnAndAnt and HowToReleasePostMavenization and [[HowToReleasePreDSBCR]] <<TableOfContents(4)>> - '''READ ALL OF THESE INSTRUCTIONS THOROUGHLY BEFORE PROCEEDING! + '''READ ALL OF THESE INSTRUCTIONS THOROUGHLY BEFORE PROCEEDING! ''' - ''' = Preparation = 1. If you have not already done so, [[http://www.apache.org/dev/release-signing.html#keys-policy|append your code signing key]] to the [[https://dist.apache.org/repos/dist/release/hadoop/common/KEYS|KEYS]] file. Once you commit your changes, they will automatically be propagated to the website. Also [[http://www.apache.org/dev/release-signing.html#keys-policy|upload your key to a public key server]] if you haven't. End users use the KEYS file (along with the [[http://www.apache.org/dev/release-signing.html#web-of-trust|web of trust]]) to validate that releases were done by an Apache committer. For more details on signing releases, see [[http://www.apache.org/dev/release-signing.html|Signing Releases]] and [[http://www.apache.org/dev/mirror-step-by-step.html?Step-By-Step|Step-By-Step Guide to Mirroring Releases]]. @@ -71, +70 @@ mvn versions:set -DnewVersion=X.Y.Z }}} - Now, for any branches in {trunk, branch-X, branch-X.Y, branch-X.Y.Z} that have changed, push them to the remote repo taking care of any conflicts. {{{ @@ -87, +85 @@ 1. On a Docker- and Internet- capable machine, build the release candidate with {{{create-release}}}. Unless the {{{--logdir}}} is given, logs will be in the {{{patchprocess/}}} directory. Artifacts will be in the target/artifacts NOTE: This will take quite a while, since it will download and build the entire source tree, including documentation and native components, from scratch to avoid maven repository caching issues hiding issues with the source release. {{{ dev-support/bin/create-release --asfrelease --docker --dockercache - }}} + }}} 1. While it should fail {{{create-release}}} if there are issues, doublecheck the rat log to find and fix any potential licensing issues. {{{ grep 'Rat check' target/artifacts/mvn_apache_rat.log - }}} + }}} 1. Check that release files look ok - e.g. install it somewhere fresh and run examples from tutorial, do a fresh build, read the release notes looking for WARNINGs, etc. 1. Set environment variable version for later steps. {{{export version=X.Y.Z-RCN}}} 1. Tag the release candidate: {{{ git tag -s release-$version -m "Release candidate - $version" - }}} + }}} 1. Push branch-X.Y.Z and the newly created tag to the remote repo. 1. Deploy the maven artifacts, on your personal computer. Please be sure you have completed the prerequisite step of preparing the {{{settings.xml}}} file before the deployment. You might want to do this in private and clear your history file as your gpg-passphrase is in clear text. {{{ @@ -135, +133 @@ svn ci -m "Publishing the bits for release ${version}" }}} 1. Update upstream branches to make them aware of this new release: - 1. Copy and commit the CHANGES.md and RELEASENOTES.md: + 1. Copy and commit the CHANGES.md and RELEASENOTES.md: - {{{ + {{{ cp target/artifacts/RELEASENOTES.md hadoop-common-project/hadoop-common/src/site/markdown/release/${version}/RELEASENOTES.${version}.md cp target/artifacts/CHANGES.md hadoop-common-project/hadoop-common/src/site/markdown/release/${version}/CHANGES.${version}.md - }}} + }}} - 1. Update {{{hadoop-project-dist/pom.xml}}} to point to this new stable version of the API and commit the change. + 1. Update {{{hadoop-project-dist/pom.xml}}} to point to this new stable version of the API and commit the change. - {{{ + {{{ <jdiff.stable.api>X.Y.Z</jdiff.stable.api> - }}} + }}} 1. In [[https://repository.apache.org|Nexus]] 1. effect the release of artifacts by selecting the staged repository and then clicking {{{Release}}} 1. If there were multiple RCs, simply drop the staging repositories corresponding to failed RCs. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
