Update release how-to after releasing 3.6.1
This commit is contained in:
parent
f16d5b1722
commit
0ff84e6a5d
|
@ -256,7 +256,9 @@ Create and transfer the artifacts to the Nexus server (a.k.a. "deploy").
|
||||||
Because the artifacts must be cryptographically signed, this step requires that
|
Because the artifacts must be cryptographically signed, this step requires that
|
||||||
a profile named "release" exists in the maven "settings.xml" configuration file
|
a profile named "release" exists in the maven "settings.xml" configuration file
|
||||||
which will contain the identifier of your GPG key (cf. sample "settings.xml"
|
which will contain the identifier of your GPG key (cf. sample "settings.xml"
|
||||||
file).
|
file). You will also have to follow the instructions at
|
||||||
|
https://maven.apache.org/guides/mini/guide-encryption.html to set your password
|
||||||
|
in the settings.xml file.
|
||||||
|
|
||||||
You can then run
|
You can then run
|
||||||
|
|
||||||
|
@ -316,7 +318,10 @@ can be published before vote ends, it is not recommended to use the standard sta
|
||||||
area for the release candidate. So you will just archive the transfer the site it on
|
area for the release candidate. So you will just archive the transfer the site it on
|
||||||
your apache personal area for review. Here is how to do this using lftp to initiate
|
your apache personal area for review. Here is how to do this using lftp to initiate
|
||||||
the sftp transfer (lftp supports a mirror command for recursive transfers, don't
|
the sftp transfer (lftp supports a mirror command for recursive transfers, don't
|
||||||
forget the -R flag for uploading instead of downloading the site):
|
forget the -R flag for uploading instead of downloading the site). If you
|
||||||
|
haven't setup your login on home.apache.org you will need to go to
|
||||||
|
https://id.apache.org/, login and copy the contents of your ~/.ssh/id_rsa.pub
|
||||||
|
file to "SSH Key (authorized_keys line)". Then run these commands:
|
||||||
|
|
||||||
$ mvn site
|
$ mvn site
|
||||||
$ cd target
|
$ cd target
|
||||||
|
@ -381,7 +386,8 @@ After correcting the problems, you'll likely have to start again from step 3,
|
||||||
(16)
|
(16)
|
||||||
After at least 72 hours have elapsed, send a "[VOTE][RESULT]" mail to
|
After at least 72 hours have elapsed, send a "[VOTE][RESULT]" mail to
|
||||||
summarize the outcome of the vote. This should tally the votes cast,
|
summarize the outcome of the vote. This should tally the votes cast,
|
||||||
and state which are binding (PMC members).
|
and state which are binding (PMC members). The vote needs at least three +1's
|
||||||
|
from PMC members to pass.
|
||||||
|
|
||||||
|
|
||||||
(17)
|
(17)
|
||||||
|
@ -419,21 +425,22 @@ Release (a.k.a. "promote") the artifacts on the Nexus server, as shown here:
|
||||||
|
|
||||||
(19)
|
(19)
|
||||||
Publish the web site. This is done by first committing the web site to the staging area, and then
|
Publish the web site. This is done by first committing the web site to the staging area, and then
|
||||||
by publishing the staging area (which is shared among all commons compoents.
|
by publishing the staging area (which is shared among all commons components.
|
||||||
|
|
||||||
In order to commit the web site to the staging area, look at the subversion workspace that was
|
In order to commit the web site to the staging area, look at the subversion
|
||||||
automatically checked out during the 'mvn site' command in folder site-content. You can also check
|
workspace that was automatically checked out during the 'mvn site' command in
|
||||||
it out directly by yourself elsewhere:
|
folder site-content. Note that svn commits in the site-content directory are
|
||||||
|
immediately synced with the live site and so your changes shoule show up in a
|
||||||
|
few minutes once you commit the new site. You can also check out the site
|
||||||
|
directly by yourself elsewhere:
|
||||||
|
|
||||||
svn checkout https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math site-content
|
svn checkout https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math site-content
|
||||||
|
|
||||||
Remove all files there (except .svn folder) and move all the files from the site.
|
Remove all files there (except .svn folder) and move all the files from the site.
|
||||||
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.4.
|
|
||||||
|
|
||||||
$ cd site-content
|
$ cd site-content
|
||||||
$ rm -fr *
|
$ rm -fr *
|
||||||
$ cp -pR ../target/site/* .
|
$ cp -pR ../target/commons-math-3.6.1-RC1-site/* .
|
||||||
|
|
||||||
Check for possibly new files:
|
Check for possibly new files:
|
||||||
$ svn status
|
$ svn status
|
||||||
|
@ -442,12 +449,7 @@ and "svn add" them if necessary.
|
||||||
Commit the new contents of the web site:
|
Commit the new contents of the web site:
|
||||||
$ svn commit -m "updating site after official release of version 3.4"
|
$ svn commit -m "updating site after official release of version 3.4"
|
||||||
|
|
||||||
Beware the commit command may be very long (several hours ...). The web site will be available
|
Beware the commit command may be very long (several hours ...).
|
||||||
for review at:
|
|
||||||
http://commons.staging.apache.org/proper/commons-math/
|
|
||||||
|
|
||||||
Publishing the staging web site is done directly from a browser at URL:
|
|
||||||
https://cms.apache.org/commons/publish
|
|
||||||
|
|
||||||
(20)
|
(20)
|
||||||
The javadocs for several version is kept available on the website under the javadocs directory.
|
The javadocs for several version is kept available on the website under the javadocs directory.
|
||||||
|
@ -460,6 +462,10 @@ the links to former versions to work. This is done as follows:
|
||||||
https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math/apidocs \
|
https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math/apidocs \
|
||||||
https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math/javadocs/api-3.4
|
https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-math/javadocs/api-3.4
|
||||||
|
|
||||||
|
Now wait a few minutes for the live site to fully sync and then check
|
||||||
|
http://commons.apache.org/proper/commons-math/ to make sure everything looks
|
||||||
|
correct.
|
||||||
|
|
||||||
(21)
|
(21)
|
||||||
Put the official final tag to point at the same commit as the last release candidate tag:
|
Put the official final tag to point at the same commit as the last release candidate tag:
|
||||||
|
|
||||||
|
@ -500,3 +506,36 @@ send (from your apache account) a release announcement to the following ML:
|
||||||
announce@apache.org
|
announce@apache.org
|
||||||
dev@commons.apache.org
|
dev@commons.apache.org
|
||||||
user@commons.apache.org
|
user@commons.apache.org
|
||||||
|
|
||||||
|
If you don't have it setup already you can follow these instructions to send
|
||||||
|
email from your apache account :
|
||||||
|
|
||||||
|
https://reference.apache.org/committer/email#sendingemailfromyourapacheorgemailaddress
|
||||||
|
|
||||||
|
You can use the following message as a template:
|
||||||
|
|
||||||
|
----------
|
||||||
|
The Apache Commons Team is pleased to announce the availability of:
|
||||||
|
|
||||||
|
Apache Commons Math 3.6.1
|
||||||
|
|
||||||
|
Apache Commons Math is a library of lightweight, self-contained mathematics and
|
||||||
|
statistics components addressing the most common problems not available in the
|
||||||
|
Java programming language or Commons Lang.
|
||||||
|
|
||||||
|
The release notes can be reviewed at:
|
||||||
|
http://www.apache.org/dist/commons/math/RELEASE-NOTES.txt
|
||||||
|
|
||||||
|
Distribution packages can be downloaded from:
|
||||||
|
https://commons.apache.org/proper/commons-math/download_math.cgi
|
||||||
|
|
||||||
|
When downloading, please verify signatures using the KEYS file available at:
|
||||||
|
http://www.apache.org/dist/commons
|
||||||
|
|
||||||
|
Maven artifacts are also available in the central Maven repository:
|
||||||
|
|
||||||
|
http://repo1.maven.org/maven2/org/apache/commons/
|
||||||
|
|
||||||
|
The Apache Commons Team
|
||||||
|
----------
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue