Mailing List Archive

svn commit: r1759463 - /perl/modperl/trunk/RELEASE
Author: stevehay
Date: Tue Sep 6 17:21:42 2016
New Revision: 1759463

URL: http://svn.apache.org/viewvc?rev=1759463&view=rev
Log:
Update RELEASE as per r1759430

Note: The latter part of this document still needs updating, which I will do in due course when making 2.0.10.

Modified:
perl/modperl/trunk/RELEASE

Modified: perl/modperl/trunk/RELEASE
URL: http://svn.apache.org/viewvc/perl/modperl/trunk/RELEASE?rev=1759463&r1=1759462&r2=1759463&view=diff
==============================================================================
--- perl/modperl/trunk/RELEASE (original)
+++ perl/modperl/trunk/RELEASE Tue Sep 6 17:21:42 2016
@@ -1,33 +1,33 @@
Instructions for mod_perl 2.0 Release Manager

-0. make sure your public key is in the KEYS file in the mod_perl docs.
- you should only need to do this if this is your first time playing
- Release Manager
+0. make sure your public key is in the KEYS file in the mod_perl docs.
+ you should only need to do this if this is your first time playing
+ Release Manager

$ cd mod_perl-docs
$ grep $USER src/dist/KEYS

- note that the KEYS file itself contains all the instructions you
- need on how to add your key. if you need further help on gpg
- (like how to create a key in the first place) you can look here
+ note that the KEYS file itself contains all the instructions you
+ need on how to add your key. if you need further help on gpg
+ (like how to create a key in the first place) you can look here

http://people.apache.org/~geoff/gpghowto.html

- Copy the KEYS file into place:
- % scp KEYS people.apache.org:/www/www.apache.org/dist/perl/KEYS
+ Copy the KEYS file into place:
+ % scp KEYS people.apache.org:/www/www.apache.org/dist/perl/KEYS

- If this is your first release, ask someone with APML karma on PAUSE
- to verify you have the appropriate permissions. Likely someone on
- the PMC can do this.
-
- a. login into https://pause.perl.org
- b. menu click: Select Mailinglist/Action
- c. choose APML and Change Permissions and click go
- d. click 3.1 Make somebody else co-maintainer
- e. choose the modules to give the perms to
- type the username of the new co-maintainer
- f. if you happen to know that packages were added this release,
- make sure you give the correct permissions to them.
+ If this is your first release, ask someone with APML karma on PAUSE
+ to verify you have the appropriate permissions. Likely someone on
+ the PMC can do this.
+
+ a. login into https://pause.perl.org
+ b. menu click: Select Mailinglist/Action
+ c. choose APML and Change Permissions and click go
+ d. click 3.1 Make somebody else co-maintainer
+ e. choose the modules to give the perms to
+ type the username of the new co-maintainer
+ f. if you happen to know that packages were added this release,
+ make sure you give the correct permissions to them.

1. 'make mydist' - to make sure nothing is missing from the manifest,
etc. Now test this generated package mod_perl-2.0.10.tar.gz (not
@@ -39,22 +39,24 @@ Instructions for mod_perl 2.0 Release Ma
- change -dev to -rc\d+ starting with -rc1
- edit META.yml to the rc\d version above in the version key

- b. nuke any preinstalled mod_perl libs and run 'make test'
+ b. commit Changes
+ % svn ci -m "2.0.10 rc1" Changes

- c. test that you can 'make install' and then run 'make test' again
+ c. nuke any preinstalled mod_perl libs and run 'make test'

- d. test whether we still 100% OK on systems with no LWP:
+ d. test that you can 'make install' and then run 'make test' again

+ e. test whether we are still 100% OK on systems with no LWP:
% APACHE_TEST_PRETEND_NO_LWP=1 make test

- e. build and test as root. double check that you have started from a
+ f. build and test as root. double check that you have started from a
fresh source, without having any stale dirs from the previous
build laying around.

-2. once confident that the package is good, upload a release candidate
- to people.apache.org/~username and post 24 hour-ish candidate alert
- to the modperl/dev list (may be longer to give most people a chance
- to catch up). no need to tag this package
+2. once confident that the package is good, commit the release candidate
+ to https://dist.apache.org/repos/dist/dev/perl and post 24 hour-ish
+ candidate alert to the modperl/dev list (may be longer to give most
+ people a chance to catch up). no need to tag this package

Subject: [RELEASE CANDIDATE]: mod_perl-2.0.10 RC\d+

@@ -77,7 +79,7 @@ Instructions for mod_perl 2.0 Release Ma
% make -n tag

d. commit Changes README Makefile.PL
- % svn ci -m "Releasing 2.0.10" Changes README Makefile.PL
+ % svn ci -m "2.0.10 release" Changes README Makefile.PL

e. tag
% make tag
@@ -96,7 +98,7 @@ Instructions for mod_perl 2.0 Release Ma
Apache-Test -r 608229 https://svn.apache.org/repos/asf/perl/Apache-Test/trunk
docs https://svn.apache.org/repos/asf/perl/modperl/docs/tags/2_0_10/src/docs/2.0

- % svn ci -m "Releasing 2.0.10"
+ % svn ci -m "2.0.10 release"

g. create the final package
% make dist
@@ -105,43 +107,38 @@ Instructions for mod_perl 2.0 Release Ma

4. Release the package and update links (e.g. mod_perl-2.0.10.tar.gz)

- a. upload to people.apache.org:/www/perl.apache.org/dist/ - ask the PMC
+ a. commit to https://dist.apache.org/repos/dist/release/perl - ask the PMC
chair to give you the needed permissions if you do not have them.

- % scp mod_perl-2.0.10.tar.gz people.apache.org:/www/perl.apache.org/dist/
-
+ XXXX: Still needs updating from here...
b. ssh to people.apache.org, unpack the package, update symlinks to the
tar ball and unpacked distro:
-
- % ssh people.apache.org
- % cd /www/perl.apache.org/dist/
- % ln -sf mod_perl-2.0.10.tar.gz mod_perl-2.0-current.tar.gz
- % tar -xzvf mod_perl-2.0.10.tar.gz
- % rm /www/perl.apache.org/dist/mod_perl-2.0-current
- % ln -sf mod_perl-2.0.10 mod_perl-2.0-current
+ % ssh people.apache.org
+ % cd /www/perl.apache.org/dist/
+ % ln -sf mod_perl-2.0.10.tar.gz mod_perl-2.0-current.tar.gz
+ % tar -xzvf mod_perl-2.0.10.tar.gz
+ % rm /www/perl.apache.org/dist/mod_perl-2.0-current
+ % ln -sf mod_perl-2.0.10 mod_perl-2.0-current

c. archive older releases (keep current + one prior release)
-
- % mv /www/perl.apache.org/dist/mod_perl-2.0.9.tar.gz \
- /www/perl.apache.org/dist/old
- % mv /www/perl.apache.org/dist/mod_perl-2.0.9.tar.gz.asc \
- /www/perl.apache.org/dist/old
- % rm -rf /www/perl.apache.org/dist/mod_perl-2.0.9
+ % mv /www/perl.apache.org/dist/mod_perl-2.0.9.tar.gz \
+ /www/perl.apache.org/dist/old
+ % mv /www/perl.apache.org/dist/mod_perl-2.0.9.tar.gz.asc \
+ /www/perl.apache.org/dist/old
+ % rm -rf /www/perl.apache.org/dist/mod_perl-2.0.9

d. update the version and release date in the docs:
- % vi modperl-docs/src/download/index_top.html
- % vi modperl-docs/doap_Perl.rdf
-
+ % vi modperl-docs/src/download/index_top.html
+ % vi modperl-docs/doap_Perl.rdf
and commit.
- % svn ci -m "Releasing 2.0.10" \
- modperl-docs/src/download/index_top.html \
- modperl-docs/doap_Perl.rdf
+ % svn ci -m "2.0.10 release" \
+ modperl-docs/src/download/index_top.html \
+ modperl-docs/doap_Perl.rdf

It'll be automatically updated within 6 hours. Alternatively
you can do a manual update by logging into www.apache.org and
running:
-
- % /home/perlwww/apache.org/modperl-docs/bin/site_build
+ % /home/perlwww/apache.org/modperl-docs/bin/site_build

You may need to sudo -H -u perlwww to cleanup any svn locks.

@@ -149,68 +146,69 @@ Instructions for mod_perl 2.0 Release Ma

6. Tarball signing

- (depending on whether you use GPG or PGP, pick the first or the
- second set of the commands):
+ (depending on whether you use GPG or PGP, pick the first or the
+ second set of the commands):

a. sign your local copy of the tarball:

- % gpg --detach-sign --armor mod_perl-2.0.10.tar.gz
+ % gpg --detach-sign --armor mod_perl-2.0.10.tar.gz

- % pgps -b --armor mod_perl-2.0.10.tar.gz
+ % pgps -b --armor mod_perl-2.0.10.tar.gz

b. upload the generated sig file to people.apache.org:
-
- % scp mod_perl-2.0.10.tar.gz.asc people.apache.org:/www/perl.apache.org/dist/
- % ssh people.apache.org
- % cd /www/perl.apache.org/dist/
- % chmod 0664 mod_perl-2.0.10.tar.gz.asc
- % ln -sf mod_perl-2.0.10.tar.gz.asc mod_perl-2.0-current.tar.gz.asc
+ % scp mod_perl-2.0.10.tar.gz.asc people.apache.org:/www/perl.apache.org/dist/
+ % ssh people.apache.org
+ % cd /www/perl.apache.org/dist/
+ % chmod 0664 mod_perl-2.0.10.tar.gz.asc
+ % ln -sf mod_perl-2.0.10.tar.gz.asc mod_perl-2.0-current.tar.gz.asc

c. ask one of the other developers to double check the signature file
and tarball: download both files and verify the signature:

- http://perl.apache.org/dist/mod_perl-2.0.10.tar.gz.asc
- http://perl.apache.org/dist/mod_perl-2.0.10.tar.gz
+ http://perl.apache.org/dist/mod_perl-2.0.10.tar.gz.asc
+ http://perl.apache.org/dist/mod_perl-2.0.10.tar.gz

- % gpg --verify mod_perl-2.0.10.tar.gz.asc
+ % gpg --verify mod_perl-2.0.10.tar.gz.asc

- % pgpv mod_perl-2.0.10.tar.gz.asc
+ % pgpv mod_perl-2.0.10.tar.gz.asc

d. make sure that the files you just created are group rw so
all the dist admins can make changes:
-
- % find /www/perl.apache.org/dist/ -user $USER -type f -print0 | xargs -0 chmod 0664
- % find /www/perl.apache.org/dist/ -user $USER -type d -print0 | xargs -0 chmod 0775
+ % find /www/perl.apache.org/dist/ -user $USER -type f -print0 | xargs -0 chmod 0664
+ % find /www/perl.apache.org/dist/ -user $USER -type d -print0 | xargs -0 chmod 0775

7. Distribute to www.apache.org/dist/perl
and archive the old package under /www/archive.apache.org/dist/perl/

a. unpack the package, update symlinks to the tarball and unpacked distro:
-
- % cd /www/www.apache.org/dist/perl/
- % cp /www/perl.apache.org/dist/mod_perl-2.0.10.tar.gz* .
- % tar -xzvf mod_perl-2.0.10.tar.gz
- % mv mod_perl-2.0.9.tar.gz* /www/archive.apache.org/dist/perl/
- % rm -rf mod_perl-2.0.9
+ % cd /www/www.apache.org/dist/perl/
+ % cp /www/perl.apache.org/dist/mod_perl-2.0.10.tar.gz* .
+ % tar -xzvf mod_perl-2.0.10.tar.gz
+ % mv mod_perl-2.0.9.tar.gz* /www/archive.apache.org/dist/perl/
+ % rm -rf mod_perl-2.0.9

b. make sure that the files you just created are group rw so
-
all the dist admins can make changes:
-
- % find /www/www.apache.org/dist/perl/ -user $USER -type f -print0 | xargs -0 chmod 0664
- % find /www/www.apache.org/dist/perl/ -user $USER -type d -print0 | xargs -0 chmod 0775
+ % find /www/www.apache.org/dist/perl/ -user $USER -type f -print0 | xargs -0 chmod 0664
+ % find /www/www.apache.org/dist/perl/ -user $USER -type d -print0 | xargs -0 chmod 0775

8. Announce the package

- a. post ... to the modperl, announce lists
- Note, to post to announce@, you must be sending from an apache.org address.
- Subject: [ANNOUNCE] mod_perl 2.0.10
- include
- - link at perl.apache.org:
- http://apache.org/dist/perl/mod_perl-2.0.10.tar.gz
- http://apache.org/dist/perl/mod_perl-2.0.10.tar.gz.asc (pgp sig)
- - MD5 sig (as it comes from CPAN upload announce).
- - the latest Changes
+ a. post to the following lists:
+
+ o modperl/perl.apache.org
+ o announce/apache.org
+
+ Note, to post to announce@, you must be sending from an apache.org address.
+
+ Subject: [ANNOUNCE] mod_perl 2.0.10
+
+ include:
+ - link at perl.apache.org:
+ http://apache.org/dist/perl/mod_perl-2.0.10.tar.gz
+ http://apache.org/dist/perl/mod_perl-2.0.10.tar.gz.asc (pgp sig)
+ - MD5 sig (as it comes from CPAN upload announce).
+ - the latest Changes

9. Prepare for the next cycle

@@ -221,17 +219,15 @@ Instructions for mod_perl 2.0 Release Ma
c. edit ./Changes:
- start a new item with incremented version + '-dev'

- =item 2.0.11-dev
+ =item 2.0.11-dev

d. add a release entry in STATUS

e. update this file versions to make it easy to copy-n-paste things
on the next release:
-
- $ perl -pi -e 's/(\d+)([._])(\d+)(\2)(\d+)/join($2, $1, $3, $5+1)/eg' RELEASE
+ % perl -pi.bak -e 's/(\d+)([._])(\d+)(\2)(\d+)/join($2, $1, $3, $5+1)/eg' RELEASE

f. commit the changed files
-
% svn ci -m "start 2.0.10-dev cycle" Changes META.yml lib/mod_perl2.pm \
STATUS RELEASE