Fixed some commands and URLS in the release documentation.
This commit is contained in:
parent
1a96973119
commit
fc7ee95d9c
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue