Child pages
  • Release Process
Skip to end of metadata
Go to start of metadata

This page documents the Apache OpenNLP release process.

Step-by-step guide

  1. Elect a release manager
  2. Create a new release in JIRA. If you do not have permissions to do so just ask to be assigned privileges on the mailing list.
  3. Review the JIRA issues associated to the release.
  4. Push off all open issues to the next release; any critical or blocker issues should be resolved on mailing list. Discuss any issues that you are unsure of on the mailing list.
  5. Make sure you have your PGP key entered into https://id.apache.org/
    1. Your KEYS will then be present in: https://people.apache.org/keys/group/opennlp.asc
  6. Check if you have your PGP keys password.
  7. Checkout the apache master
  8. Update the distribution README file: https://github.com/apache/opennlp/blob/trunk/opennlp-distr/README
    1. Commit the changes
  9. Execute a complete test (it takes several hours).

    Merge no source code changes after running the tests, or we will need to rerun it.

  10. Do a trial build with:

  11. Execute release prepare:

  12. Answer all questions
  13. If it finished with success, do a release perform

  14. (this will create a X.Y.Z release tag in GIT that you can use for VOTE'ing in your VOTE email. 
  15. It will also create a staged repository at http://repository.apache.org. Check the staged repository and if all looks well, close the repository, but don't release it yet).
  16. The build results is in opennlp/target/checkout/target/
  17. Perform basic check in the release binary (signature, presence of license, issues folder, execute the CLI)
  18. If VOTE passes with 3+ OpenNLP PMC votes, move onto next step. If VOTE does not pass, repeat steps 5-on until it does.
  19. Close the successful release vote
  20. Promote the nexus staging repo
  21. SNV the distribution to https://dist.apache.org/repos/dist/release/

     

  22. Update the web site: distribution, maven dependency version, documentation. Wait for 26 to finish to promete the website changes.
  23. Wait for versions to hit the mirrors (hint: keep checking http://www.apache.org/dyn/closer.cgi/opennlp until you see something).
  24. Promote the website changes.
  25. Send announcement email to announce@a.o and dev@opennlp.a.o and user@opennlp.a.o. This needs to be done from your @apache.org email address or the email will bounce from the announce list. Gmail forwarding can help here and is a snap to set up (http://gmailblog.blogspot.com/2009/07/send-mail-from-another-address-without.html). It's even easier then the instructions there as it will recognize your email address and default to Apache settings. It is important to include a description of what OpenNLP is as well as a link to the updated DOAP within the release announcement, this is so others know what OpenNLP is.