Creating a Release for Subprojects

This page documents the requirements for releasing a Click subproject.

Please note this section is for committers only.

Prerequisites

Subprojects have the same prerequisites as Click. See here for details.

Release Procedure

Subproject releases should adhere to the following steps:
  1. Create the distribution using your favorite build tool e.g. Ant.
  2. Create MD5 and SHA1 hashes of the distribution file.
  3. Digitally sign the distribution, for example: 
    gpg --armor --output ClickIDE-X.X.X-incubating.zip.asc --detach-sig ClickIDE-X.X.X-incubating.zip
  4. Upload the distribution to your account at people.apache.org under the folder ~/public_html/click/SUBPROJECT/X.X.X, where SUBPROJECT is the name of the subproject and X.X.X is the version.

    For example version 2.2.0 of subproject ClickIDE could be published to: 

    ~/public_html/click/clickide/2.2.0
  5. Verify the digital signatures at people.apache.org to ensure nothing went wrong with the upload.

    Please note if this is the first time you verify your key at people.apache.org, you'll need to import your public key first.

    Assuming your public key ID is '709F7561' and your key is available from the public key server 'pgp.mit.edu', the following command will import the key on people.apache.org: 

    ssh people.apache.org
gpg --keyserver pgp.mit.edu --recv-keys 709F7561
    Next verify the signature with the following command: (Replace SUBPROJECT with the name of the actual project.) 
    ssh people.apache.org
cd ~/public_html/click/SUBPROJECT/X.X.X
gpg --verify SUBPROJECT-X.X.X-incubating.zip.asc SUBPROJECT-X.X.X-incubating.zip
  6. Releases must be voted on before they are published. Please see the Voting section for details.
  7. Incubating releases are published at people.apache.org under the folder:

    /www/www.apache.org/dist/incubator/click/SUBPROJECT/X.X.X

    For example ClickIDE will be published to the folder:

    /www/www.apache.org/dist/incubator/click/clickide/X.X.X

    An easy way to do this is to copy the files in your public_html folder for example: 

    ssh people.apache.org
cp ~/public_html/click/clickide/X.X.X/* /www/www.apache.org/dist/incubator/click/clickide/X.X.X
  8. Email release announcement to click-user and click-dev mailing lists.