...
The general incubator release guide is available here: http://incubator.apache.org/guides/releasemanagement.html
but since we are out of incubation the docs are here: http://www.apache.org/dev/release
The apache central maven repo release guide is available here: http://www.apache.org/dev/publishing-maven-artifacts.html
The release process takes about one hour to perform, don't do this in a hurry as it is important to perform each step in the correct order!
...
- you have created your GPG keys. For more information, please refer to Making GPG Keys and http://www.apache.org/dev/release-signing.html .
- you have a GPG client installed and on your shell's path. See http://www.gnupg.org/
.
- you have a Subversion 1.5+ client installed and on your shell's path. See http://subversion.tigris.org/
.
- you have a Java 1.4.2 JDK installed and on your shell's path. See http://java.sun.com/j2se/1.4.2/download.html
.
- you have set the environment variable MAVEN_OPTS=-Xmx512m
- you are using Maven 2.0.x or 2.2.1+, as Maven 2.1.x is known to produce wrong gpg pom signatures (see MGPG-14).
...
Download the latest JDK 6 http://www.oracle.com/technetwork/java/javase/downloads/jdk6-downloads-1637591.html
Create a mvn6 shell script and add it to your PATH. This script makes sure you use Java 6 to build the release.
...
Edit CHANGELOG.txt in you favorite editor and add the closed issues for this release. Info can be exported from jira.
Go to: https://issues.apache.org/jira/browse/EMPIREDB/
In the versions due section go to the version you want to release
Click on release notes
Configure release notes to text
Copy the notes to our CHANGELOG.txt
...
Make sure your code is up to date, builds, is available in your snapshot repository and has no local changes
Info | |
---|---|
|
Code Block |
---|
>mvn6 clean install ... >mvn6 clean release:clean ... >mvn6 release:prepare -Papache-release ... [INFO] Checking dependencies and plugins for snapshots ... What is the release version for "Apache Empire-db Parent"? (org.apache.empire-db:empire-db-parent) 2.0.5: : What is SCM release tag or label for "Apache Empire-db Parent"? (org.apache.empire-db:empire-db-parent) empire-db-parent-2.0.5: : apache-empire-db-2.0.5-rc3 What is the new development version for "Apache Empire-db Parent"? (org.apache.empire-db:empire-db-parent) 2.0.6-SNAPSHOT: : [INFO] Transforming 'Apache Empire-db Parent'... [INFO] Updating empire-db to 2.0.5 ... |
...
Close the staging repository
Go to: https://repository.apache.org and log in
Follow the steps as described on http://maven.apache.org/developers/release/releasing.html (Close the staging repository)
...
TODO we might want to switch to https://dist.apache.org/repos/dist/dev/<TLP name>/
as explained here: http://www.apache.org/dev/release#upload-ci
Code Block |
---|
>cd target/checkout/empire-db-dist (we want to have the same artifacts in the dist as in the repo) >./checksums.sh ... All Done. Files available in ./target |
...
Initiate a vote
Docs here: http://www.apache.org/dev/release#approving-a-release
The vote mail should look like this:unmigrated-wiki-markup
To: dev@empire-db.apache.org
Subject: \ [VOTE\] Release Apache Empire-db 2.0.5 (rc3)
Hi,
We have just prepared a 2.0.5 release and we are now looking for approval of the PMC to publish the release.
More info on release requirements can be found here: http://www.apache.org/dev/release#approving-a-releaseThese are the major changes from our previous 2.0.4 release:
- xxx
- xxx
Changelog: http://svn.apache.org/viewvc/empire-db/tags/apache-empire-db-2.0.5-rc3/CHANGELOG.txt?view=co
Subversion tag: https://svn.apache.org/repos/asf/empire-db/tags/apache-empire-db-2.0.5-rc3
Maven staging repository: https://repository.apache.org/content/repositories/orgapacheempire-db-044/
Distribution files are located here http://people.apache.org/~francisdb/empire-db/
Rat report for the tag is available here: http://people.apache.org/~francisdb/empire-db/rat.txt
Vote open for 72 hours.
[ ] +1
[ ] +0
[ ] -1
...
Log in to nexus as described above,
Go to: https://repository.apache.org and log in
Follow the steps as described on http://maven.apache.org/developers/release/releasing.html
(go to the staging section, right click on the staged release and select release)
Set up new release in JIRA / close old one
- Go to https://issues.apache.org/jira/browse/EMPIREDB
- Click on Administer Project /Administration
- Click on Manage versions
- Release current version
- Create new / edit versions if needed
Move the release files to the dist location
Docs here: http://www.apache.org/dev/release#upload-ci
- svn checkout https://dist.apache.org/repos/dist/release/empire-db/
empire-db-dist-release
- Create a subdirectory with the version number (i.e. 2.0.5)
- Copy all distribution files from your apache home directory to that directory (.zip, .tar.gz, .asc, .md5, .sha)
scp francisdb@people.apache.org:~/public_html/empire-db/apache-empire-db-* . - commit to the subversion repo
- Wait (one day) before files become available on the mirrors
...
- Check out or update the Empire-db website source files from https://svn.apache.org/repos/asf/empire-db/site
- Update the doap_Empire-db.rdf file, add new version
- Edit Pages with html editor (I am using Microsoft Expression Web)
- Open page downloads/latest.htm and copy section with previous release files to downloads/previous.htm.
- In downloads/latest.htm replace all reference to old version number with new version number.
- Update news.html
- so a svn delete on javadocs/empire-db
- commit
- recreate the empire-db folder
- fetch the new javadoc jar from http://repo1.maven.org/maven2/org/apache/empire-db/empire-db/x.x.x/empire-db-x.x.x-javadoc.jar
- extract into the javadocs/empire-db folder
- svn add the empire-db folder
- Commit all changes to svn repo.
- Wait some time for changes to become available on the mirrors.
...
Start the mail as follows:unmigrated-wiki-markup
Subject: \ [ANNOUNCE\] Apache Empire-db xxx released
The Apache Empire-db team is pleased to announce the release of Apache Empire-db version xxx.
Apache Empire-db is a lightweight data access and persistence component for relational databases based on JDBC. http://empire-db.apache.org/
\[add description and list of changes\] Wiki Markup Changelog: http://svn.apache.org/viewvc/empire-db/tags/apache-empire-db-xxx/CHANGELOG.txt?view=co
Download: http://empire-db.apache.org/downloads/latest.htm
Thank you for your interest in Apache Empire-db!
The Apache Empire-db Team.
...