[howto] release instrument packages

14 Jun 2004 08:48:47 -0000 

Hi gang!

Mauro needs the instrument packages released. I told him that could take a while, but it might not be if he has the time to do it himself! So I propose he volunteers as release manager :-D. Make sure to read

  http://wiki.apache.org/avalon/AvalonReleaseManagerHowto

basically, you need to do something like this:

  * get your gpg key into a file called KEYS that needs to be created
    at

    https://svn.apache.org/repos/asf/excalibur/trunk/KEYS

  * copy this file to

    /www/www.apache.org/dist/excalibur

    which I've already set up (I just checked, Noel added mnash
    and mauro to the appropriate group, so you should have write
    access unlike most of the rest of us), ie

    wget https://svn.apache.org/repos/asf/excalibur/trunk/KEYS
    scp KEYS minotaur.apache.org:/www/www.apache.org/dist/excalibur

  * update project.xml. Probably need to change the version numbers.
    Commit the changes.

    cd ~/svn/excalibur/trunk
    vim instrument/project.xml
    vim instrument-manager/project.xml
    vim instrument-client/project.xml
    svn commit -m 'prepare for releases'

    or something like that.

  * tag appropriate files in svn to mark the release candidates

    svn copy \
      https://svn.apache.org/repos/asf/excalibur/trunk/instrument
      https://svn.apache.org/repos/asf/excalibur/tags/instrument-1.2-RC1
    svn copy \
https://svn.apache.org/repos/asf/excalibur/trunk/instrument-manager
https://svn.apache.org/repos/asf/excalibur/tags/instrument-manager-1.2-RC1
    svn copy \
https://svn.apache.org/repos/asf/excalibur/trunk/instrument-client
https://svn.apache.org/repos/asf/excalibur/tags/instrument-client-1.2-RC1

    or something like that.

  * build distributions, ie

    maven multiproject:install
    cd instrument
    maven dist
    cd ../instrument-manager
    maven dist
    cd ../instrument-client
    maven dist

    or something like that.

  * copy the releases somewhere, ie

    mkdir releases
    find . -path './instrument-.*/target/.*(gz|zip|jar)' \
      | xargs cp --target-directory=releases

    or something like that.

  * temporary get rid of your gpg passphrase

    sudo /sbin/ifdown eth0
    gpg --edit-key <YOUR ID>
    > key <YOURKEY>
    > passwd
    <YOUR PASSPHRASE>
    <enter>
    <enter>
    yes
    quit
    yes

    or something like that.

  * sign the releases

    cd releases
    for i in `ls`; do
      gpg -v --output $i.asc --detach-sig --armor $i
    done

    or something like that.

  * restore your gpg passphrase

    gpg --edit-key <YOUR ID>
    > key <YOURKEY>
    > passwd
    <YOUR PASSPHRASE>
    <YOUR PASSPHRASE>
    quit
    yes
    sudo /sbin/ifup eth0

    or something like that.

  * upload distributions to your personal webspace at apache

    ssh minotaur.apache.org
    umask 002
    mkdir -p ~/public_html/excalibur/release-candidates
    chmod o+rx ~ ~/public_html ~/public_html/excalibur \
      ~/public_html/release-candidates
    exit
    umask 002
    scp * minotaur.apache.org:~/public_html/excalibur/release-candidates

    or something like that.

  * ask for feedback on [EMAIL PROTECTED]

  * probably go through several iterations of the above as some
    last-minute bugs are hammered out

  * call for a PMC vote to release the files

  * if the vote passes, tag svn again and copy your candidates
    to the distribution server

    svn copy \
      https://svn.apache.org/repos/asf/excalibur/trunk/instrument
      https://svn.apache.org/repos/asf/excalibur/tags/instrument-1.2
    ssh minotaur.apache.org
    umask 002
    mkdir /www/www.apache.org/dist/excalibur/instrument
    mkdir /www/www.apache.org/dist/excalibur/instrument-manager
    mkdir /www/www.apache.org/dist/excalibur/instrument-client
    cd ~/public_html/excalibur/release-candidates/
    cp -r excalibur-instrument-1.2.* \
      /www/www.apache.org/dist/excalibur/instrument
    cp -r excalibur-instrument-manager-1.2.* \
      /www/www.apache.org/dist/excalibur/instrument-manager
    cp -r excalibur-instrument-client-1.2.* \
      /www/www.apache.org/dist/excalibur/instrument-client

    or something like that.

  * send out announcements to the appropriate mailing lists

yes, this is a horrible process. I used to have some scripts that automated most of it, but I have no idea where they are atm. I plan to write a giant script (will probably be in ruby) that automates all of this.


cheers,


- LSD

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Apache Excalibur Project -- URL: http://excalibur.apache.org/

Reply via email to