...
Wiki Markup |
---|
The commons-build plugin generates the download page in {{./src/site/xdoc/download_\[commons-foo\].xml}} based on {{commons.release.version}} |
No Format |
---|
mvn commons:download-page
|
Update the release notes
Ensure that the release notes refer to the release version, not snapshot. If using automatic release note generation from changes.xml, the following command should update the file:
...
The site should appear on the specified folder.
Send Out The Vote
Below you find a vote template to save you some time ...Alternatively, you can stage the site in your public_html folder in your home directory on people.apache.org. This can be done with the following command:
No Format |
---|
Tag: httpsmvn site:stage-deploy -DstagingSiteURL=scp://svnpeople.apache.org/reposhome/asf<ApacheID>/public_html/foo-1.2rc1 |
Send Out The Vote
Below you find a vote template to save you some time ...
No Format |
---|
Tag: https://svn.apache.org/repos/asf/commons/proper/commons/proper/YOUR_PROJECT/tags/${commons.rc.version} Site: http://people.apache.org/builds/commons/YOUR_PROJECT/${commons.release.version}/${commons.rc.version}/site/index.html Binaries: Add the Nexus URL to your binary artifacts, f. e. https://repository.apache.org/content/repositories/snapshots/org/apache/commons/commons-compress [ ] +1 release it [ ] +0 go ahead I don't care [ ] -1 no, do not release it because |
...
Check the MD5/SHA hashes!
Also, change the group to commons:
No Format |
---|
chown :commons *
|
Copy to dist
On people.apache.org, change directory to the distribution directory for your component:
...
This can be done for instance with the verify_sigs.sh script available under https://svn.apache.org/repos/
...
...
...
tools/releases (just check out from SVN and place the shell scripts in the bin folder below your home directory).
Also, change the group to commons and ensure that the files can be written by the group:
No Format |
---|
chgrp commons *
chmod g+w *
|
Copy to dist
On people.apache.org, change directory to the distribution directory for your component:
No Format |
---|
cd /www/www.apache.org/dist/commons/foo/
|
Move source
Move source distributions, their detached signatures and md5 sums into position. All source versions live in the source subdirectory.
No Format |
---|
mv ~/foo-1.2-RC3/commons-foo-1.2-src* source
|
Move the binary distributions, their detached signatures and md5 sums into position. All binary source versions live in the binaries source subdirectory.
No Format |
---|
mv ~/foo-1.2-RC3/commons-foo-1.2-binsrc* binariessource |
Move the binary distributions, their detached signatures and md5 sums into position. All binary versions live in the binaries subdirectory.
No Format |
---|
mv ~/foo-1.2-RC3/commons-foo-1.2-bin* binaries
|
Double check the permissions for both binaries and source distributions. The file permissions Double check the permissions for both binaries and source distributions. The file permissions should be "rw-rw-r-" and the group should be "commons", for example:
...
- Examine the directory listing page. At the bottom should be found the information you entered into the README.html. Please check that this is correct.
- Check the KEYS file
- Check the RELEASE-NOTES.txt
- Download and verify the current distributions, the following might help committers/tools/releases/verify_sigs.sh.
- Follow the links to the binaries and source directories. Check them in a similar manner.
Publish the website
Run the following to deploy the new component website:
No Format |
---|
mvn site:deploy
|
On people.apache.org, verify that the directory has been updated, and that the file and directory permissions are correct (readable by all, not writeable by world, but group writeable). Also, ensure that the group is set to 'commons'. For example:
No Format |
---|
pwd commons.apache.org : ls -l compress
total 1366
drwxrwsr-x 5 niallp commons 20 Aug 19 07:22 apidocs
-rw-rw-r-- 1 grobmeier commons 21050 Aug 19 09:19 changes-report.html
drwxrwsr-x 5 niallp commons 98 Aug 19 07:22 cobertura
-rw-rw-r-- 1 grobmeier commons 7555 Aug 19 09:19 conventions.html
|
- tools/releases/verify_sigs.sh.
- Follow the links to the binaries and source directories. Check them in a similar manner.
Publish the website
See httpsNote that the files are transferred to the real web site only every few hours, so it may be a while before you see your changes appear. However if you set your webbrowser's HTTP proxy to 140.211.11.10 port 80 and access http://commons.apache.org/ you should be able to see the changes immediately.site-publish.html
Send announcement
Announce the availability of the new release. Please check that the mirrors have been updated with the new release before sending the announce. There is no need to check all mirrors, but it's worthwhile checking a few of them.
...
- Remove Obsolete Releases: Unless old versions are especially required, remove them from the dist directory. This will cause the files to also be deleted from the mirrors and save them some diskspace as well as simplifying things for users. Note that the contents of the /www/www.apache.org/dist directory is regularly copied to /www/archive.apache.org/dist and from there transferred to host archive.apache.org. Deleting files from the standard distribution directories does not delete them from the archive dist directories so users will still be able to access old files even when they are not available from the mirrors.
- Update JIRA: Mark the release as released in the JIRA project admin and CLOSE all issues RESOLVED in this release. Make sure the FIX VERSION for all issues closed with this release is set correctly to this version. If this has not already been done, create a JIRA version for the next release.
- Update DOAP file: Update the component's DOAP file with details of the released version:
No Format |
---|
<release>
<Version>
<name>x.y.z</name>
<created>yyyy-mm-dd</created>
<revision>x.y.z</revision>
</Version>
</release>
|
- Update changes.xml: If the component uses the maven changes plugin to maintain its changelog, fill in the release date for the just released version and create a new release element for the next release.
- Create the relase tag: Copy the tag of the RC whose vote succeeded to the final release tag, e.g.
No Format |
---|
svn copy https://svn.apache.org/repos/asf/commons/proper/foo/tags/FOO_1.2RC1 https://svn.apache.org/repos/asf/commons/proper/foo/tags/FOO_1.2 -m "Tagging 1.2 release" |