Fixed some commands and URLS in the release documentation.

This commit is contained in:
Luc Maisonobe 2014-12-18 21:34:55 +01:00
parent 1a96973119
commit fc7ee95d9c
1 changed files with 23 additions and 18 deletions

View File

@ -95,7 +95,7 @@ should create the artifacts in the "target/deploy".
At this point, you will work mainly on the release-candidates branch. At this point, you will work mainly on the release-candidates branch.
If the release-candidates branch does not exist because it is the first release If the release-candidates branch does not exist because it is the first release
candidate, create it starting from the master branch: candidate, create it locally starting from the master branch:
$ git branch release-candidates $ git branch release-candidates
@ -104,6 +104,10 @@ Switch to the release candidate branch:
$ git checkout release-candidates $ git checkout release-candidates
Push the local branch to Apache repository (assuming it is called origin):
$ git push --set-upstream origin release-candidates
(4) (4)
If there have been changes committed in the master branch since the creation of If there have been changes committed in the master branch since the creation of
the release candidate branch, there are two cases: the release candidate branch, there are two cases:
@ -274,7 +278,7 @@ repository.
As a measure of sanity check, repository must be manually "closed" before other As a measure of sanity check, repository must be manually "closed" before other
people review the deliverables just created. people review the deliverables just created.
How to "close" the staging repository it is explained at this page: How to "close" the staging repository it is explained at this page:
https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository http://books.sonatype.com/nexus-book/reference/staging-repositories.html#staging-sect-closing
(12) (12)
Upload the other distribution files to the Apache servers. Upload the other distribution files to the Apache servers.
@ -287,9 +291,11 @@ following commands:
$ cd /tmp $ cd /tmp
$ svn checkout https://dist.apache.org/repos/dist/dev/commons/math $ svn checkout https://dist.apache.org/repos/dist/dev/commons/math
$ cp ~/.m2/repository/org/apache/commons/commons-math/3.2*-bin.* binaries $ cd math
$ cp ~/.m2/repository/org/apache/commons/commons-math/3.2*-src.* source $ cp ~/.m2/repository/org/apache/commons/commons-math3/3.2*-bin.* binaries
$ cp ~/.m2/repository/org/apache/commons/commons-math3/3.2*-src.* source
$ cp <path-to-the-RC-workspace>/RELEASE-NOTES.txt . $ cp <path-to-the-RC-workspace>/RELEASE-NOTES.txt .
$ svn add RELEASE-NOTES.txt binaries/* source/*
$ svn commit -m "Creating distribution files for 3.2 RC1" $ svn commit -m "Creating distribution files for 3.2 RC1"
@ -297,22 +303,21 @@ following commands:
Web site testing (a.k.a "staging") of the generated web site (containing the Web site testing (a.k.a "staging") of the generated web site (containing the
API documentation, etc.) API documentation, etc.)
This step requires a "<server>" with an identifier set to "stagingSite" and This step uses the svnpubsub mechanism, which means that the site content is
that the remote server is set up to accept no-password ssh authentification stored in an svn repository and committing it directly update the staging area
(cf. sample "settings.xml" file). of the site
Execute the commands (assuming the release candidate is "RC1"):
$ mvn site $ mvn site
and and
$ mvn site:stage-deploy \ $ cd site-content
-DstagingDirectory=src/site \ $ rm -fr *
-DstagingSiteURL=scp://__Your_apache_login__@people.apache.org:/www/people.apache.org/builds/commons/math/3.2/RC1 $ cp -pR ../target/site/* .
$ svn commit -m "updating site for RC1"
The web site will be available for review at: The web site will be available for review at:
http://people.apache.org/builds/commons/math/3.2/RC1 http://commons.staging.apache.org/proper/commons-math/
(14) (14)
@ -326,7 +331,7 @@ Tag (and how to check its GPG signature):
git tag -v MATH_3_2_RC1 git tag -v MATH_3_2_RC1
Site: Site:
http://people.apache.org/builds/commons/math/3.2/RC1/ http://commons.staging.apache.org/proper/commons-math/
Distribution files: Distribution files:
https://dist.apache.org/repos/dist/dev/commons/math/ https://dist.apache.org/repos/dist/dev/commons/math/
@ -383,13 +388,13 @@ $ svnmucc -U https://dist.apache.org/repos/dist \
(18) (18)
Release (a.k.a. "promote") the artifacts on the Nexus server, as shown here: Release (a.k.a. "promote") the artifacts on the Nexus server, as shown here:
https://docs.sonatype.org/display/Repository/Releasing+a+Staging+Repository http://books.sonatype.com/nexus-book/reference/staging-repositories.html#staging-sect-releasing
(19) (19)
Publish the web site. From your local working copy of the tag, run the command: Publish the web site. This is done by publishing the staging area, directly
from a browser at URL:
$ mvn site-deploy https://cms.apache.org/commons/publish
You may want to adjust manually some parts like fixing broken relative links or You may want to adjust manually some parts like fixing broken relative links or
copying the content of the current apidocs to javadocs/api-3.2. In order to do copying the content of the current apidocs to javadocs/api-3.2. In order to do