Currently, this is just a collection area for my rough notes and what-not. It will soon be a much cleaner guide.
Speaking of guides, here are a bunch of good ones:
http://accumulo.apache.org/releasing.html
http://accumulo.apache.org/verifying_releases.html
http://nifi.apache.org/release-guide.html
http://yetus.apache.org/contribute/releases/
Basic Outline:
Dependencies
- You need to be a commiter
- Basic Rya
- Checkout, build, test Rya
- Setting up PGP
- Getting software
- creating a key
- publishing a key
- adding your key to id.apache.org
- Setting up Maven to push to apache repo
- Username/pass in maven settings
- Testing settings
- Testing locally:
- mvn clean install -Papache-release
Testing by pushing to apache snapshot repo
mvn clean deploy -Papache-release
- Testing locally:
Use gpg-agent, and be sure to increase the gpg-agent cache timeout (via .gnupg/gpg-agent.conf) to ensure that the agent doesn’t require re-authentication mid-build, as it will cause things to fail. For example, you can add default-cache-ttl 6000 to increase the timeout from the default of 10 minutes to over an hour. If you do not have a GPG key, reference the very thorough ASF release signing documentation. (make sure you reset gpg-agent:
echo RELOADAGENT | gpg-connect-agent
)
Staging a release
note: I followed these instructions: http://www.apache.org/dev/publishing-maven-artifacts.html#prepare-poms
- Update Rya
- Build a push a signed snapshot
mvn clean deploy -Papache-release
Do some manual checks (note I think that the mvn release plugin does all of this)
Make sure there are no dependencies on snapshots in the POMs to be released
Check that your POMs will not lose content when they are rewritten during the release process
mvn release:prepare -Papache-release -DdryRun=true -Darguments="-DskipTests"
Diff the original file pom.xml with the one called pom.xml.tag to see if the license or any other info has been removed
What is the release version for "Apache Rya Project"? (org.apache.rya:rya-project) 3.2.10: :
What is SCM release tag or label for "Apache Rya Project"? (org.apache.rya:rya-project) rya-project-3.2.10: : 3.2.10
What is the new development version for "Apache Rya Project"? (org.apache.rya:rya-project) 3.2.11-SNAPSHOT: :
Prepare release
mvn release:clean
mvn release:prepare
- Stage release for a vote
mvn release:perform
References:
http://www.apache.org/dev/publishing-maven-artifacts.html