...
- Build the release (binary and source versions) after running unit tests. Note that this will generate MD5 checksum files automatically. {{{
ant test tar binary
% md5sum -c hive-0.6.0Code Block # Verify that the MD5 checksums are valid:
No Format % ant -Dversion=X.Y.Z clean test tar binary
- Verify that the MD5 checksums are valid:
No Format % md5sum -c hive-X.Y.Z.tar.gz.md5
hive-X.Y.Z.tar.gz: OK
% md5sum -c hive-
...
X.
...
Y.
...
Z-bin.tar.gz.md5
...
hive-X.Y.Z-bin.tar.gz: OK
...
- Check
...
- that
...
- release
...
- file
...
- looks
...
- ok
...
- -
...
- e.g.
...
- install
...
- it
...
- and
...
- run
...
- examples
...
- from
...
- tutorial.
...
- Sign
...
- the
...
- release
...
- (see
...
...
...
...
...
...
- for
...
- more
...
- information).
No Format %
...
gpg --armor --output hive-X.Y.Z.tar.gz.asc --detach-sig hive-X.Y.Z.tar.gz
...
% gpg --armor --output hive-X.Y.Z-bin.tar.gz.asc --detach-sig hive-X.Y.Z-bin.tar.gz
...
- Copy
...
- release
...
- files
...
- to
...
- a
...
- public
...
- place.
No Format %
...
ssh people.apache.org mkdir public_html/hive-X.Y.Z-candidate-0
...
% scp -p hive-X.Y.Z*.tar.gz* people.apache.org:public_html/hive-X.Y.Z-candidate-0
...
- Call a release vote on dev at hive.apache.org.
...
Publishing
Once three PMC members have voted for a release, it may be published.
- Tag the release:
No Format svn move
...
https://svn.apache.org/repos/asf/hive/tags/release-X.Y.Z-rcR
...
\ https://svn.apache.org/repos/asf/hive/tags/release-X.Y.Z
...
-m "HiveX.Y.Z release."
...
Code Block |
---|
# Copy release files to the distribution directory and make them writable by the hive group. |
...
- Copy release files to the distribution directory and make them writable by the hive group.
No Format ssh people.apache.org
...
cp -pR public_html/hive-X.Y.Z-candidate-0/ /www/www.apache.org/dist/hive/hive-X.Y.Z
...
cd /www/www.apache.org/dist/hive
...
chgrp -R hive hive-X.Y.Z
...
chmod -R g+w hive-X.Y.Z
...
Code Block |
---|
# The release directory usually contains just two releases, the most recent from two branches, with a link named 'stable' to the most recent recommended version. |
...
- The release directory usually contains just two releases, the most recent from two branches, with a link named 'stable' to the most recent recommended version.
No Format ssh people.apache.org
...
cd /www/www.apache.org/dist/hive
...
rm -rf hive-A.B.C; rm stable
...
ln -s hive-A.B.D stable
...
Code Block |
---|
# Wait 24 hours for release to propagate to mirrors.
## Prepare to edit the website. |
...
- Wait 24 hours for release to propagate to mirrors.
- Prepare to edit the website.
No Format svn co https://svn.apache.org/repos/asf/hive/site
- Prepare to edit the website.
...
- Update the documentation links in
author/src/documentation/content/xdocs/site.xml
...
- .
- Update the release news in
author/src/documentation/content/xdocs/releases.xml
...
- .
- Regenerate the site,
...
- review
...
- it,
...
- then
...
- commit
...
- it.
...
Code Block ant -Dforrest.home=/usr/local/forrest -Djava5.home=/usr/local/jdk1.5
...
firefox publish/index.html
...
svn commit -m "Updated site for release X.Y.Z."
...
- Deploy
...
- your
...
- site
...
- changes.
...
Code Block ssh people.apache.org
...
cd /www/hive.apache.org
...
svn up
...
- Copy the new release docs to
people.apache.org:/www/hive.apache.org/docs/rX.Y.Z
...
- and
...
- update
...
- the
...
docs/current
...
- link,
...
- by
...
- doing
...
- the
...
- following
...
- in
...
- your
...
- home
...
- directory
...
- on
...
- people.apache.org:
...
Code Block ssh people.apache.org
...
tar xvf /www/www.apache.org/dist/hive/hive-X.Y.Z/hive-X.Y.Z.tar.gz '*/docs'
...
chmod -R ug=rwX,o=rX hive-X.Y.Z
...
chgrp -R hive hive-X.Y.Z
...
cp -rp hive-X.Y.Z/docs /www/hive.apache.org/docs/rX.Y.Z
...
rm -r hive-X.Y.Z
...
cd /www/hive.apache.org/docs/
...
ln -s rX.Y.Z current
...
- Send announcements to the user and developer lists once the site changes are visible.
- In JIRA, ensure that only issues in the "Fixed" state have a "Fix Version" set to release X.Y.Z.
- In JIRA, "release" the version. Visit the "Administer Project" page, then the "Manage versions" page. You need to have the "Admin" role in Hive's Jira for this step and the next.
- In JIRA, close issues resolved in the release. Disable mail notifications for this bulk change.
...