• Created by Unknown User (bgchun), last updated on Jan 23, 2015 2 minute read

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

The Apache release management process is described in the guide to release management during incubation page.

  1. If you have not done creating and posting your PGP key, please do by following the next instructions.
    The key must be at least 4096 bits long. 
    Publish the public key to a public PGP server
    Register its fingerprint in Apache LDAP
    scp the public key to .pgpkey under your Apache home directory
    Append the public key to the KEYS file. You can access the KEYS file via https://dist.apache.org/repos/dist/release/incubator/reef.
    Upload your public key to Apache (e.g., https://people.apache.org/keys/committer/bgchun.asc). 
    You can find useful bits from the release signing basic facts page.

  2. Prepare for a source release candidate for PPMC voting.
    The release must not contain binary files. 
    The release must contain proper DISCLAIMER, NOTICE, and LICENSE files. 
    The source file must compile and run tests successfully. 
    mvn apache-rat:check passes.

  3. Create a source release candidate gzipped tar ball, its signature (with PGP), and digests (md5, sha1, and sha512). 
    The release candidate name is apache-reef-<version>-incubating-rc<rc candidate number>.tar.gz.
    For example, the following commands create a release candidate and relevant files for 0.10.0 rc1.

    tar cfz apache-reef-0.10.0-incubating-rc1.tar.gz apache-reef-0.10.0-incubating-rc1
    gpg --armor -u <public key id (8 hex numbers)> --output apache-reef-0.10.0-incubating-rc1.tar.gz.asc --detach-sig apache-reef-0.10.0-incubating-rc1.tar.gz 
    openssl dgst -md5 apache-reef-0.10.0-incubating-rc1.tar.gz > apache-reef-0.10.0-incubating-rc1.tar.gz.md5
    openssl dgst -sha1 apache-reef-0.10.0-incubating-rc1.tar.gz > apache-reef-0.10.0-incubating-rc1.tar.gz.sha1
    openssl dgst -sha512 apache-reef-0.10.0-incubating-rc1.tar.gz > apache-reef-0.10.0-incubating-rc1.tar.gz.sha512

    In addition, the release manager must prepare for maven artifacts. The detailed procedure is here. 

    Note. After the first release, most of the information needed in POMs are set correctly. The version in POMs for staging maven artifacts must be *-SNAPSHOT. In contrast, the version in POMs for the source release must be the final release version.
    The release manager can handle the differences between source release and maven artifacts by creating two release branches. 

  4. Do PPMC voting at dev@reef. If the release candidate receives any -1 or does not receive three +1's, the release candidate is cancelled. The release manager should prepare for a new release candidate by fixing the problems raised by PPMC members and do voting for the new release candidate. This process can iterate multiple times.

  5. Do IPMC voting at general@incubator. The voting email should contain the PPMC voting result thread. If at least three IPMC members cast +1 binding votes (with no -1 vote), the vote passes. If not, the release manager should prepare for a new release candidate and do PPMC and IMPC voting.

  6. When the IPMC vote passes, the release candidate becomes a release. The location of the release is under https://dist.apache.org/repos/dist/release/incubator/reef. Create a directory with the release version name and add the release, its signature, and digests. 
    In addition, the manager promotes maven artifacts in the Nexus staging repository.
  • No labels