You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@continuum.apache.org by de...@apache.org on 2010/01/11 22:51:20 UTC
svn commit: r898083 - in /continuum/site/src/site:
apt/development/building.apt apt/development/debugging.apt
apt/development/release.apt apt/events.apt cwiki/confluence-template.txt
resources/.htaccess
Author: dennisl
Date: Mon Jan 11 21:51:20 2010
New Revision: 898083
URL: http://svn.apache.org/viewvc?rev=898083&view=rev
Log:
Set EOL-style to Native.
Modified:
continuum/site/src/site/apt/development/building.apt (contents, props changed)
continuum/site/src/site/apt/development/debugging.apt (props changed)
continuum/site/src/site/apt/development/release.apt (contents, props changed)
continuum/site/src/site/apt/events.apt (props changed)
continuum/site/src/site/cwiki/confluence-template.txt (contents, props changed)
continuum/site/src/site/resources/.htaccess (props changed)
Modified: continuum/site/src/site/apt/development/building.apt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/apt/development/building.apt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/apt/development/building.apt (original)
+++ continuum/site/src/site/apt/development/building.apt Mon Jan 11 21:51:20 2010
@@ -1,103 +1,103 @@
- -------
- Building Continuum
- -------
- ------
- 2010-01-07
- ------
-
-Building Continuum
-
- This document will help you check out and build the Continuum source code.
-
-* Quick Start
-
-+--------+
- svn co http://svn.apache.org/repos/asf/continuum/all continuum-all
- cd /path/to/continuum-all/parent
- mvn install
- cd /path/to/continuum-all/continuum
- mvn install
-+--------+
-
- After a successful build, you will find the Continuum distributions in
- <<<continuum-jetty/target>>> and the WAR file in <<<continuum-webapp/target>>>.
-
-* Maven
-
- To build Continuum, you will need {{{http://maven.apache.org/}Apache Maven}}.
- {{{http://maven.apache.org/download.html}Download}} and {{{http://maven.apache.org/download.html#Installation}
- install}} the the latest stable version.
-
-* Subversion
-
- The Continuum source code is stored in a {{{/source-repository.html}Subversion repository}} hosted by The
- Apache Software Foundation. You will need a Subversion client in order to check out the source code. A list of
- Subversion downloads and third-party clients is available on the {{{http://subversion.tigris.org/}Subversion}} web
- site.
-
-* All
-
- In the Subversion repo, there is a convenience 'all' directory with an svn:externals definition that allows you to check out
- the trunk, parent POM and site all at once. It will look empty when viewed in
- your web browser, but checking it out with your Subversion client will bring down all
- the code.
-
- {{{http://svn.apache.org/repos/asf/continuum/all}
- http://svn.apache.org/repos/asf/continuum/all}}
-
-* Trunk
-
- The trunk of the Subversion repo has version 1.4.x, from which we're publishing
- milestones. You can find more information about planned features on the
- {{{http://cwiki.apache.org/confluence/display/CONTINUUM/Continuum+Roadmap}Roadmap}}.
- If you see something interesting, please join us on the {{{/mail-lists.html}dev list}} to talk about it!
-
- {{{http://svn.apache.org/repos/asf/continuum/trunk}
- http://svn.apache.org/repos/asf/continuum/trunk}}
-
-* Parent
-
- The Continuum parent POM contains configuration that is common to the entire
- project. It has a separate, less frequent release cycle than the distribution.
-
- {{{http://svn.apache.org/repos/asf/continuum/parent/trunk}
- http://svn.apache.org/repos/asf/continuum/parent/trunk}}
-
-* Site
-
- The source for the top-level Continuum website (including this page) is in a
- separate directory in Subversion. It is published when changes are made, but
- it is not tagged and "released".
-
- {{{http://svn.apache.org/repos/asf/continuum/site}
- http://svn.apache.org/repos/asf/continuum/site}}
-
-* Branches
-
- We currently have one active release branch for 1.3.x bug fixes,
- and several branches for ongoing work. Generally there will be some discussion
- on the dev list or a JIRA issue opened before a branch is created.
-
- {{{http://svn.apache.org/repos/asf/continuum/branches}
- http://svn.apache.org/repos/asf/continuum/branches}}
-
-* Sandbox
-
- The sandbox is an area where committers are free to experiment. No notice is
- required to create something in the sandbox.
-
- {{{http://svn.apache.org/repos/asf/continuum/sandbox}
- http://svn.apache.org/repos/asf/continuum/sandbox}}
-
-* Tags
-
- Tags for all past releases, test builds, and interesting points in time are
- available.
-
- {{{http://svn.apache.org/repos/asf/continuum/tags}
- http://svn.apache.org/repos/asf/continuum/tags}}
-
-* Help
-
- If you need help finding something or building it, please ask on the dev list
- or on irc.
+ -------
+ Building Continuum
+ -------
+ ------
+ 2010-01-07
+ ------
+
+Building Continuum
+
+ This document will help you check out and build the Continuum source code.
+
+* Quick Start
+
++--------+
+ svn co http://svn.apache.org/repos/asf/continuum/all continuum-all
+ cd /path/to/continuum-all/parent
+ mvn install
+ cd /path/to/continuum-all/continuum
+ mvn install
++--------+
+
+ After a successful build, you will find the Continuum distributions in
+ <<<continuum-jetty/target>>> and the WAR file in <<<continuum-webapp/target>>>.
+
+* Maven
+
+ To build Continuum, you will need {{{http://maven.apache.org/}Apache Maven}}.
+ {{{http://maven.apache.org/download.html}Download}} and {{{http://maven.apache.org/download.html#Installation}
+ install}} the the latest stable version.
+
+* Subversion
+
+ The Continuum source code is stored in a {{{/source-repository.html}Subversion repository}} hosted by The
+ Apache Software Foundation. You will need a Subversion client in order to check out the source code. A list of
+ Subversion downloads and third-party clients is available on the {{{http://subversion.tigris.org/}Subversion}} web
+ site.
+
+* All
+
+ In the Subversion repo, there is a convenience 'all' directory with an svn:externals definition that allows you to check out
+ the trunk, parent POM and site all at once. It will look empty when viewed in
+ your web browser, but checking it out with your Subversion client will bring down all
+ the code.
+
+ {{{http://svn.apache.org/repos/asf/continuum/all}
+ http://svn.apache.org/repos/asf/continuum/all}}
+
+* Trunk
+
+ The trunk of the Subversion repo has version 1.4.x, from which we're publishing
+ milestones. You can find more information about planned features on the
+ {{{http://cwiki.apache.org/confluence/display/CONTINUUM/Continuum+Roadmap}Roadmap}}.
+ If you see something interesting, please join us on the {{{/mail-lists.html}dev list}} to talk about it!
+
+ {{{http://svn.apache.org/repos/asf/continuum/trunk}
+ http://svn.apache.org/repos/asf/continuum/trunk}}
+
+* Parent
+
+ The Continuum parent POM contains configuration that is common to the entire
+ project. It has a separate, less frequent release cycle than the distribution.
+
+ {{{http://svn.apache.org/repos/asf/continuum/parent/trunk}
+ http://svn.apache.org/repos/asf/continuum/parent/trunk}}
+
+* Site
+
+ The source for the top-level Continuum website (including this page) is in a
+ separate directory in Subversion. It is published when changes are made, but
+ it is not tagged and "released".
+
+ {{{http://svn.apache.org/repos/asf/continuum/site}
+ http://svn.apache.org/repos/asf/continuum/site}}
+
+* Branches
+
+ We currently have one active release branch for 1.3.x bug fixes,
+ and several branches for ongoing work. Generally there will be some discussion
+ on the dev list or a JIRA issue opened before a branch is created.
+
+ {{{http://svn.apache.org/repos/asf/continuum/branches}
+ http://svn.apache.org/repos/asf/continuum/branches}}
+
+* Sandbox
+
+ The sandbox is an area where committers are free to experiment. No notice is
+ required to create something in the sandbox.
+
+ {{{http://svn.apache.org/repos/asf/continuum/sandbox}
+ http://svn.apache.org/repos/asf/continuum/sandbox}}
+
+* Tags
+
+ Tags for all past releases, test builds, and interesting points in time are
+ available.
+
+ {{{http://svn.apache.org/repos/asf/continuum/tags}
+ http://svn.apache.org/repos/asf/continuum/tags}}
+
+* Help
+
+ If you need help finding something or building it, please ask on the dev list
+ or on irc.
Propchange: continuum/site/src/site/apt/development/building.apt
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: continuum/site/src/site/apt/development/debugging.apt
------------------------------------------------------------------------------
svn:eol-style = native
Modified: continuum/site/src/site/apt/development/release.apt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/apt/development/release.apt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/apt/development/release.apt (original)
+++ continuum/site/src/site/apt/development/release.apt Mon Jan 11 21:51:20 2010
@@ -1,266 +1,266 @@
- ------
- Continuum Release Guidelines
- ------
-
-Continuum Release Guidelines
-
-
- * Continuum is versioned X.Y.Z -- Major.Minor.Build. The Major and Minor versions are set at the beginning of a
- series, after which we use sequential build numbers starting with .0. For example, 1.3.0, 1.3.1, 1.3.2.
-
- * Ideally each version is tagged and built exactly once. The Release Manager (RM) has discretion to re-build a
- version if something goes wrong during the release process, but once a version has been made available for public
- download, that version number may not be re-used.
-
- * During the vote, an additional qualifier is determined. For example: 1.3.0 (M1) or 1.3.7 (GA). Respectively,
- these mean Milestone 1 and General Availability. Qualifiers such as Alpha and Beta are also acceptable, as is RC
- (Release Candidate).
-
- * If the vote does not pass, the qualifier may be reused. For example, if 1.3.0 was meant to be Milestone 1 but
- does not get approved, 1.3.1 can become M1.
-
- * When releases are announced to the community, the additional qualifier is used in addition to the version number.
- For example: [ANN] Continuum 1.3.3 (Milestone 2) Release or [ANN] Continuum 1.3.6 (GA) Release
-
- * A qualifier can be changed by calling a new vote. If we get to 1.3.8 (M5) and decide that it has no problems and
- there's nothing else we want to add, we can simply re-label it GA and update the website.
-
- * New features may be added to 1.3.x releases until we reach GA, at which point only minor changes should be made.
-
- * If the vote does not pass, the binaries should be removed from the download area, and the version should be
- labeled "test build" on the release notes page.
-
-Continuum Release Preparation
-
- [[1]] Post to the dev list a few days before you plan to do a Continuum release
-
- [[2]] Check for SNAPSHOT dependencies, including the Continuum parent POM
-
- [[1]] Update <<<continuum-docs/src/site/xdoc/release-notes.xml>>>
-
- * Copy and paste the html release notes from JIRA
-
- * Add <<<\<h1\>>>> around the first line
-
- []
-
- [[1]] Update the <<<site.xml>>> for version changes
-
- [[1]] Make sure that you have the "release" profile set in your <<<settings.xml>>> as shown below.
-
-+-----+
-<profile>
- <id>release</id>
- <properties>
- <gpg.passphrase>[GPG_PASS_PHRASE]</gpg.passphrase>
- </properties>
-</profile>
-+-----+
-
- [[1]] Set your user credentials for the stage repo in the <<<<servers>>>> section of your <<<settings.xml>>> file.
-
-Continuum Release Process
-
- By default, the release will be staged in <<<http://people.apache.org/builds/continuum/$\{version\}/staging-repo>>>.
- If you want to stage it elsewhere, set the <<<deploy.altRepository>>> property in your <<<settings.xml>>> file.
-
- [[1]] Execute <<<mvn release:prepare>>> (check that it has been properly tagged. The tag name must be <<<continuum-[VERSION]>>>)
-
- <<Note:>> SCM tag does not work with Subversion \> 1.5.1
-
- * Use subversion 1.4.1 or
-
- * After SCM tag fails with an error 'svn: File ... already exists',
- do an svn update first then resume the release preparation from the SCM tag phase.
-
-+-----+
-svn up
-mvn release:prepare
-+-----+
-
- []
-
- [[1]] Then execute <<<mvn release:perform>>>
-
- [[1]] ssh to <<<people.apache.org>>> and cd to <<</www/people.apache.org/builds/continuum/VERSION>>>. Execute the following commands to copy and rename the source and binary distributions.
-
-+-----+
-export VER=1.3.4
-
-find staging-repo -name "*.zip*" -exec cp {} . \;
-find staging-repo -name "*.tar.gz*" -exec cp {} . \;
-find staging-repo -name "*.war*" -exec cp {} . \;
-find . -name "*.asc.*" -exec rm {} \;
-
-mv continuum-$VER.zip apache-continuum-$VER-src.zip
-mv continuum-$VER.zip.md5 apache-continuum-$VER-src.zip.md5
-mv continuum-$VER.zip.sha1 apache-continuum-$VER-src.zip.sha1
-mv continuum-$VER.zip.asc apache-continuum-$VER-src.zip.asc
-
-mv continuum-jetty-$VER-bin.tar.gz apache-continuum-$VER-bin.tar.gz
-mv continuum-jetty-$VER-bin.tar.gz.md5 apache-continuum-$VER-bin.tar.gz.md5
-mv continuum-jetty-$VER-bin.tar.gz.sha1 apache-continuum-$VER-bin.tar.gz.sha1
-mv continuum-jetty-$VER-bin.tar.gz.asc apache-continuum-$VER-bin.tar.gz.asc
-
-mv continuum-jetty-$VER-bin.zip apache-continuum-$VER-bin.zip
-mv continuum-jetty-$VER-bin.zip.md5 apache-continuum-$VER-bin.zip.md5
-mv continuum-jetty-$VER-bin.zip.sha1 apache-continuum-$VER-bin.zip.sha1
-mv continuum-jetty-$VER-bin.zip.asc apache-continuum-$VER-bin.zip.asc
-
-mv continuum-webapp-$VER.war apache-continuum-$VER.war
-mv continuum-webapp-$VER.war.asc apache-continuum-$VER.war.asc
-mv continuum-webapp-$VER.war.md5 apache-continuum-$VER.war.md5
-mv continuum-webapp-$VER.war.sha1 apache-continuum-$VER.war.sha1
-
-mv continuum-buildagent-jetty-$VER-bin.tar.gz apache-continuum-buildagent-$VER-bin.tar.gz
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.md5 apache-continuum-buildagent-$VER-bin.tar.gz.md5
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.sha1 apache-continuum-buildagent-$VER-bin.tar.gz.sha1
-mv continuum-buildagent-jetty-$VER-bin.tar.gz.asc apache-continuum-buildagent-$VER-bin.tar.gz.asc
-
-mv continuum-buildagent-jetty-$VER-bin.zip apache-continuum-buildagent-$VER-bin.zip
-mv continuum-buildagent-jetty-$VER-bin.zip.md5 apache-continuum-buildagent-$VER-bin.zip.md5
-mv continuum-buildagent-jetty-$VER-bin.zip.sha1 apache-continuum-buildagent-$VER-bin.zip.sha1
-mv continuum-buildagent-jetty-$VER-bin.zip.asc apache-continuum-buildagent-$VER-bin.zip.asc
-
-mv continuum-buildagent-webapp-$VER.war apache-continuum-buildagent-$VER.war
-mv continuum-buildagent-webapp-$VER.war.asc apache-continuum-buildagent-$VER.war.asc
-mv continuum-buildagent-webapp-$VER.war.md5 apache-continuum-buildagent-$VER.war.md5
-mv continuum-buildagent-webapp-$VER.war.sha1 apache-continuum-buildagent-$VER.war.sha1
-
-mv continuum-buildagent-$VER.zip apache-continuum-buildagent-$VER-src.zip
-mv continuum-buildagent-$VER.zip.md5 apache-continuum-buildagent-$VER-src.zip.md5
-mv continuum-buildagent-$VER.zip.sha1 apache-continuum-buildagent-$VER-src.zip.sha1
-mv continuum-buildagent-$VER.zip.asc apache-continuum-buildagent-$VER-src.zip.asc
-
-script available with
-svn cat https://svn.apache.org/repos/asf/continuum/trunk/release-script.sh > release-script.sh
-+-----+
-
-~~ TODO: copy and rename in one pass?
-
- [[1]] Stage the site <<<mvn site:stage-deploy -DstagingSiteURL=scp://people.apache.org/home/USERID/public_html/staging-sites/continuum/1.3.4>>> from the release tag or <<<target/checkout>>> directory
-
- [[1]] Call for a vote in the dev list and wait for 72 hours for the vote results. 3 binding votes from PMC members are necessary for the release to be finalized. <<{{{http://markmail.org/message/dhgdoz6aht6w5frl}Example}}>>
-
- [[1]] After the vote has passed, copy the sources and binaries from <<<people.apache.org>>> to <<</www/www.apache.org/dist/continuum>>>.
-
- [[1]] To sync the JARs to the central repository, execute:
-
-+-----+
-mvn stage:copy -Dsource="[STAGE_REPO_URL]"
- -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
- -Dversion=1.3.4 -DrepositoryId=apache.releases
-+-----+
-
- <<Note:>> Do not use Maven 2.0.9 because it has a bug when performing <<<mvn stage:copy>>>
-
- [[1]] Execute fix permissions scripts. Login to <<<people.apache.org>>>
-
-+-----+
-/www/people.apache.org/repo/m2-snapshot-repository/fix-permissions.sh
-+-----+
-
- [[1]] Publish the docs with <<<mvn site-deploy>>> from the release tag
-
- [[1]] Update the Continuum site at <<<https://svn.apache.org/repos/asf/continuum/site/>>> with the versions and release notes
- URL and run <<<mvn site-deploy>>>. Below is the list of pages that you need to update:
-
- * <<<src/site/xdoc/index.xml>>>
-
- * <<<src/site/apt/known-issues.apt>>>
-
- * <<<src/site/apt/versions.apt>>>
-
- * <<<src/site/apt/download.apt>>>
-
- * <<<src/site/apt/changelog.apt>>>
-
- * <<<src/site/resources/.htaccess>>> - update
- <<<Redirect Permanent /docs/current http://continuum.apache.org/docs/1.0.1/>>> to the latest released GA version
-
- []
-
- [[1]] Remove old versions from <<</www/www.apache.org/dist/continuum>>>
-
- [[1]] Publish the reference docs (<<<mvn site-deploy>>> from the release tag.
- You may have to exclude the <<<continuum-webapp>>> module to do this, and will require <<<MAVEN_OPTS=-Xmx256m>>>
-
- [[1]] Send out an announcement of the release
-
-Verifying a Release
-
- Download the uploaded files via wget:
-
-+-----+
- wget http://people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin.tar.gz
-+-----+
-
- Verify the signatures:
-
-+-----+
- gpg -v apache-continuum-1.3.4-bin.zip.asc
-+-----+
-
- Verify the checksums:
-
-+-----+
- md5sum apache-continuum-1.3.4-src.zip
- cat apache-continuum-1.3.4-src.zip.md5
-
- sha1sum apache-continuum-1.3.4-src.zip
- cat apache-continuum-1.3.4-src.zip.sha1
-+-----+
-
-Publishing a release
-
- Tally the vote and reply on the vote thread. I prefer not to change the subject line as it breaks threading in some clients.
-
- Copy the distribution files over to www.a.o/dist/continuum
-
-+-----+
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-src* /www/www.apache.org/dist/continuum/source/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
-cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-src* /www/www.apache.org/dist/continuum/source/
-+-----+
-
- Promote the staged repository contents
-
-+-----+
-mvn stage:copy -Dsource="http://people.apache.org/builds/continuum/1.3.4/staging-repo" \
--Dtarget="scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository" \
--Dversion=1.3.4 \
--DtargetRepositoryId=apache.releases
-+-----+
-
- <<Note:>> This copies <<everything>> in the staging repo, even if you specify a version
-
- Update the <<<index.xml>>> and <<<downloads.apt>>> pages on the main site
-
- Publish the versioned reference docs (<<<mvn site-deploy>>> from a checkout of the tag)
-
- Publish the top-level website
-
- Announce the release on the dev and user lists
-
- Optionally announce on the Apache announcements list (only for major versions?)
-
- Remove old releases from www.a.o/dist (make sure to remove them from <<<downloads.apt>>> or the links will be broken)
-
- Open a bottle of champagne ! :-)
-
-Releasing the parent POM
-
- Check out the source from <<<https://svn.apache.org/repos/asf/continuum/parent>>>
-
- * <<<mvn release:prepare>>> (verify that it has been properly tagged)
-
- * <<<mvn release:perform>>> (verify that it has been deployed correctly in the staging repo)
-
- * Update the parent POM version in Continuum at <<<https://svn.apache.org/repos/asf/continuum/trunk>>> (or in the branch)
-
- * Change the parent POM version to the <<<continuum-parent>>> version that has just been released
-
- * Commit the changes made
+ ------
+ Continuum Release Guidelines
+ ------
+
+Continuum Release Guidelines
+
+
+ * Continuum is versioned X.Y.Z -- Major.Minor.Build. The Major and Minor versions are set at the beginning of a
+ series, after which we use sequential build numbers starting with .0. For example, 1.3.0, 1.3.1, 1.3.2.
+
+ * Ideally each version is tagged and built exactly once. The Release Manager (RM) has discretion to re-build a
+ version if something goes wrong during the release process, but once a version has been made available for public
+ download, that version number may not be re-used.
+
+ * During the vote, an additional qualifier is determined. For example: 1.3.0 (M1) or 1.3.7 (GA). Respectively,
+ these mean Milestone 1 and General Availability. Qualifiers such as Alpha and Beta are also acceptable, as is RC
+ (Release Candidate).
+
+ * If the vote does not pass, the qualifier may be reused. For example, if 1.3.0 was meant to be Milestone 1 but
+ does not get approved, 1.3.1 can become M1.
+
+ * When releases are announced to the community, the additional qualifier is used in addition to the version number.
+ For example: [ANN] Continuum 1.3.3 (Milestone 2) Release or [ANN] Continuum 1.3.6 (GA) Release
+
+ * A qualifier can be changed by calling a new vote. If we get to 1.3.8 (M5) and decide that it has no problems and
+ there's nothing else we want to add, we can simply re-label it GA and update the website.
+
+ * New features may be added to 1.3.x releases until we reach GA, at which point only minor changes should be made.
+
+ * If the vote does not pass, the binaries should be removed from the download area, and the version should be
+ labeled "test build" on the release notes page.
+
+Continuum Release Preparation
+
+ [[1]] Post to the dev list a few days before you plan to do a Continuum release
+
+ [[2]] Check for SNAPSHOT dependencies, including the Continuum parent POM
+
+ [[1]] Update <<<continuum-docs/src/site/xdoc/release-notes.xml>>>
+
+ * Copy and paste the html release notes from JIRA
+
+ * Add <<<\<h1\>>>> around the first line
+
+ []
+
+ [[1]] Update the <<<site.xml>>> for version changes
+
+ [[1]] Make sure that you have the "release" profile set in your <<<settings.xml>>> as shown below.
+
++-----+
+<profile>
+ <id>release</id>
+ <properties>
+ <gpg.passphrase>[GPG_PASS_PHRASE]</gpg.passphrase>
+ </properties>
+</profile>
++-----+
+
+ [[1]] Set your user credentials for the stage repo in the <<<<servers>>>> section of your <<<settings.xml>>> file.
+
+Continuum Release Process
+
+ By default, the release will be staged in <<<http://people.apache.org/builds/continuum/$\{version\}/staging-repo>>>.
+ If you want to stage it elsewhere, set the <<<deploy.altRepository>>> property in your <<<settings.xml>>> file.
+
+ [[1]] Execute <<<mvn release:prepare>>> (check that it has been properly tagged. The tag name must be <<<continuum-[VERSION]>>>)
+
+ <<Note:>> SCM tag does not work with Subversion \> 1.5.1
+
+ * Use subversion 1.4.1 or
+
+ * After SCM tag fails with an error 'svn: File ... already exists',
+ do an svn update first then resume the release preparation from the SCM tag phase.
+
++-----+
+svn up
+mvn release:prepare
++-----+
+
+ []
+
+ [[1]] Then execute <<<mvn release:perform>>>
+
+ [[1]] ssh to <<<people.apache.org>>> and cd to <<</www/people.apache.org/builds/continuum/VERSION>>>. Execute the following commands to copy and rename the source and binary distributions.
+
++-----+
+export VER=1.3.4
+
+find staging-repo -name "*.zip*" -exec cp {} . \;
+find staging-repo -name "*.tar.gz*" -exec cp {} . \;
+find staging-repo -name "*.war*" -exec cp {} . \;
+find . -name "*.asc.*" -exec rm {} \;
+
+mv continuum-$VER.zip apache-continuum-$VER-src.zip
+mv continuum-$VER.zip.md5 apache-continuum-$VER-src.zip.md5
+mv continuum-$VER.zip.sha1 apache-continuum-$VER-src.zip.sha1
+mv continuum-$VER.zip.asc apache-continuum-$VER-src.zip.asc
+
+mv continuum-jetty-$VER-bin.tar.gz apache-continuum-$VER-bin.tar.gz
+mv continuum-jetty-$VER-bin.tar.gz.md5 apache-continuum-$VER-bin.tar.gz.md5
+mv continuum-jetty-$VER-bin.tar.gz.sha1 apache-continuum-$VER-bin.tar.gz.sha1
+mv continuum-jetty-$VER-bin.tar.gz.asc apache-continuum-$VER-bin.tar.gz.asc
+
+mv continuum-jetty-$VER-bin.zip apache-continuum-$VER-bin.zip
+mv continuum-jetty-$VER-bin.zip.md5 apache-continuum-$VER-bin.zip.md5
+mv continuum-jetty-$VER-bin.zip.sha1 apache-continuum-$VER-bin.zip.sha1
+mv continuum-jetty-$VER-bin.zip.asc apache-continuum-$VER-bin.zip.asc
+
+mv continuum-webapp-$VER.war apache-continuum-$VER.war
+mv continuum-webapp-$VER.war.asc apache-continuum-$VER.war.asc
+mv continuum-webapp-$VER.war.md5 apache-continuum-$VER.war.md5
+mv continuum-webapp-$VER.war.sha1 apache-continuum-$VER.war.sha1
+
+mv continuum-buildagent-jetty-$VER-bin.tar.gz apache-continuum-buildagent-$VER-bin.tar.gz
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.md5 apache-continuum-buildagent-$VER-bin.tar.gz.md5
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.sha1 apache-continuum-buildagent-$VER-bin.tar.gz.sha1
+mv continuum-buildagent-jetty-$VER-bin.tar.gz.asc apache-continuum-buildagent-$VER-bin.tar.gz.asc
+
+mv continuum-buildagent-jetty-$VER-bin.zip apache-continuum-buildagent-$VER-bin.zip
+mv continuum-buildagent-jetty-$VER-bin.zip.md5 apache-continuum-buildagent-$VER-bin.zip.md5
+mv continuum-buildagent-jetty-$VER-bin.zip.sha1 apache-continuum-buildagent-$VER-bin.zip.sha1
+mv continuum-buildagent-jetty-$VER-bin.zip.asc apache-continuum-buildagent-$VER-bin.zip.asc
+
+mv continuum-buildagent-webapp-$VER.war apache-continuum-buildagent-$VER.war
+mv continuum-buildagent-webapp-$VER.war.asc apache-continuum-buildagent-$VER.war.asc
+mv continuum-buildagent-webapp-$VER.war.md5 apache-continuum-buildagent-$VER.war.md5
+mv continuum-buildagent-webapp-$VER.war.sha1 apache-continuum-buildagent-$VER.war.sha1
+
+mv continuum-buildagent-$VER.zip apache-continuum-buildagent-$VER-src.zip
+mv continuum-buildagent-$VER.zip.md5 apache-continuum-buildagent-$VER-src.zip.md5
+mv continuum-buildagent-$VER.zip.sha1 apache-continuum-buildagent-$VER-src.zip.sha1
+mv continuum-buildagent-$VER.zip.asc apache-continuum-buildagent-$VER-src.zip.asc
+
+script available with
+svn cat https://svn.apache.org/repos/asf/continuum/trunk/release-script.sh > release-script.sh
++-----+
+
+~~ TODO: copy and rename in one pass?
+
+ [[1]] Stage the site <<<mvn site:stage-deploy -DstagingSiteURL=scp://people.apache.org/home/USERID/public_html/staging-sites/continuum/1.3.4>>> from the release tag or <<<target/checkout>>> directory
+
+ [[1]] Call for a vote in the dev list and wait for 72 hours for the vote results. 3 binding votes from PMC members are necessary for the release to be finalized. <<{{{http://markmail.org/message/dhgdoz6aht6w5frl}Example}}>>
+
+ [[1]] After the vote has passed, copy the sources and binaries from <<<people.apache.org>>> to <<</www/www.apache.org/dist/continuum>>>.
+
+ [[1]] To sync the JARs to the central repository, execute:
+
++-----+
+mvn stage:copy -Dsource="[STAGE_REPO_URL]"
+ -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
+ -Dversion=1.3.4 -DrepositoryId=apache.releases
++-----+
+
+ <<Note:>> Do not use Maven 2.0.9 because it has a bug when performing <<<mvn stage:copy>>>
+
+ [[1]] Execute fix permissions scripts. Login to <<<people.apache.org>>>
+
++-----+
+/www/people.apache.org/repo/m2-snapshot-repository/fix-permissions.sh
++-----+
+
+ [[1]] Publish the docs with <<<mvn site-deploy>>> from the release tag
+
+ [[1]] Update the Continuum site at <<<https://svn.apache.org/repos/asf/continuum/site/>>> with the versions and release notes
+ URL and run <<<mvn site-deploy>>>. Below is the list of pages that you need to update:
+
+ * <<<src/site/xdoc/index.xml>>>
+
+ * <<<src/site/apt/known-issues.apt>>>
+
+ * <<<src/site/apt/versions.apt>>>
+
+ * <<<src/site/apt/download.apt>>>
+
+ * <<<src/site/apt/changelog.apt>>>
+
+ * <<<src/site/resources/.htaccess>>> - update
+ <<<Redirect Permanent /docs/current http://continuum.apache.org/docs/1.0.1/>>> to the latest released GA version
+
+ []
+
+ [[1]] Remove old versions from <<</www/www.apache.org/dist/continuum>>>
+
+ [[1]] Publish the reference docs (<<<mvn site-deploy>>> from the release tag.
+ You may have to exclude the <<<continuum-webapp>>> module to do this, and will require <<<MAVEN_OPTS=-Xmx256m>>>
+
+ [[1]] Send out an announcement of the release
+
+Verifying a Release
+
+ Download the uploaded files via wget:
+
++-----+
+ wget http://people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin.tar.gz
++-----+
+
+ Verify the signatures:
+
++-----+
+ gpg -v apache-continuum-1.3.4-bin.zip.asc
++-----+
+
+ Verify the checksums:
+
++-----+
+ md5sum apache-continuum-1.3.4-src.zip
+ cat apache-continuum-1.3.4-src.zip.md5
+
+ sha1sum apache-continuum-1.3.4-src.zip
+ cat apache-continuum-1.3.4-src.zip.sha1
++-----+
+
+Publishing a release
+
+ Tally the vote and reply on the vote thread. I prefer not to change the subject line as it breaks threading in some clients.
+
+ Copy the distribution files over to www.a.o/dist/continuum
+
++-----+
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-1.3.4-src* /www/www.apache.org/dist/continuum/source/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-bin* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4.war* /www/www.apache.org/dist/continuum/binaries/
+cp /www/people.apache.org/builds/continuum/1.3.4/apache-continuum-buildagent-1.3.4-src* /www/www.apache.org/dist/continuum/source/
++-----+
+
+ Promote the staged repository contents
+
++-----+
+mvn stage:copy -Dsource="http://people.apache.org/builds/continuum/1.3.4/staging-repo" \
+-Dtarget="scp://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository" \
+-Dversion=1.3.4 \
+-DtargetRepositoryId=apache.releases
++-----+
+
+ <<Note:>> This copies <<everything>> in the staging repo, even if you specify a version
+
+ Update the <<<index.xml>>> and <<<downloads.apt>>> pages on the main site
+
+ Publish the versioned reference docs (<<<mvn site-deploy>>> from a checkout of the tag)
+
+ Publish the top-level website
+
+ Announce the release on the dev and user lists
+
+ Optionally announce on the Apache announcements list (only for major versions?)
+
+ Remove old releases from www.a.o/dist (make sure to remove them from <<<downloads.apt>>> or the links will be broken)
+
+ Open a bottle of champagne ! :-)
+
+Releasing the parent POM
+
+ Check out the source from <<<https://svn.apache.org/repos/asf/continuum/parent>>>
+
+ * <<<mvn release:prepare>>> (verify that it has been properly tagged)
+
+ * <<<mvn release:perform>>> (verify that it has been deployed correctly in the staging repo)
+
+ * Update the parent POM version in Continuum at <<<https://svn.apache.org/repos/asf/continuum/trunk>>> (or in the branch)
+
+ * Change the parent POM version to the <<<continuum-parent>>> version that has just been released
+
+ * Commit the changes made
Propchange: continuum/site/src/site/apt/development/release.apt
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: continuum/site/src/site/apt/events.apt
------------------------------------------------------------------------------
svn:eol-style = native
Modified: continuum/site/src/site/cwiki/confluence-template.txt
URL: http://svn.apache.org/viewvc/continuum/site/src/site/cwiki/confluence-template.txt?rev=898083&r1=898082&r2=898083&view=diff
==============================================================================
--- continuum/site/src/site/cwiki/confluence-template.txt (original)
+++ continuum/site/src/site/cwiki/confluence-template.txt Mon Jan 11 21:51:20 2010
@@ -1,94 +1,94 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
-
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-<html>
- <head>
- <title>$page.title</title>
-
-<!-- TODO: need some of these styles, not all
- <link type="text/css" rel="stylesheet" href="$stylesheet" />
--->
- <style type="text/css" media="all">
- @import url("http://maven.apache.org/scm/css/maven-base.css");
- @import url("http://maven.apache.org/scm/css/maven-theme.css");
- @import url("http://maven.apache.org/scm/css/site.css");
- #leftColumn {
- display: none !important
- }
- #bodyColumn {
- margin-left: 1.5em;
- }
- </style>
- <link rel="stylesheet" href="http://maven.apache.org/scm/css/print.css" type="text/css" media="print" />
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
- </head>
- <body class="composite">
- <div id="banner">
- <!-- TODO: Add a Banner for Continuum site -->
- </div>
- <div id="breadcrumbs">
-
- <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml files -->
- <div class="xleft">
- $autoexport.breadcrumbs($page)
- </div>
- <div class="xright">
- <a href="http://www.apache.org/" class="externalLink">Apache</a>
- |
- <a href="http://maven.apache.org/continuum" class="externalLink">Continuum</a>
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- <div id="leftColumn">
- <div id="navcolumn">
- <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml files -->
- </div>
- </div>
- <div id="bodyColumn">
- <div id="contentBox">
-
- <div class="wiki-content">
- $body
- </div>
-
- </div>
- </div>
- <div class="clear">
- <hr/>
- </div>
- <div id="footer">
- <div class="xleft">
- #editReport()
- (<a href="$confluenceUri/pages/editpage.action?pageId=$page.id">edit page</a>)
- </div>
-
- <!-- TODO: year -->
- <div class="xright">©
- 2001-2008
-
- Apache Software Foundation
-
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- </body>
-</html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+ <head>
+ <title>$page.title</title>
+
+<!-- TODO: need some of these styles, not all
+ <link type="text/css" rel="stylesheet" href="$stylesheet" />
+-->
+ <style type="text/css" media="all">
+ @import url("http://maven.apache.org/scm/css/maven-base.css");
+ @import url("http://maven.apache.org/scm/css/maven-theme.css");
+ @import url("http://maven.apache.org/scm/css/site.css");
+ #leftColumn {
+ display: none !important
+ }
+ #bodyColumn {
+ margin-left: 1.5em;
+ }
+ </style>
+ <link rel="stylesheet" href="http://maven.apache.org/scm/css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <!-- TODO: Add a Banner for Continuum site -->
+ </div>
+ <div id="breadcrumbs">
+
+ <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml files -->
+ <div class="xleft">
+ $autoexport.breadcrumbs($page)
+ </div>
+ <div class="xright">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ |
+ <a href="http://maven.apache.org/continuum" class="externalLink">Continuum</a>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+ <!-- TODO: make it an include so that it can be modified by Maven, or process site.xml files -->
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+ <div class="wiki-content">
+ $body
+ </div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">
+ #editReport()
+ (<a href="$confluenceUri/pages/editpage.action?pageId=$page.id">edit page</a>)
+ </div>
+
+ <!-- TODO: year -->
+ <div class="xright">©
+ 2001-2008
+
+ Apache Software Foundation
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: continuum/site/src/site/cwiki/confluence-template.txt
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: continuum/site/src/site/resources/.htaccess
------------------------------------------------------------------------------
svn:eol-style = native