commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@apache.org
Subject svn commit: r1460220 - /commons/cms-site/trunk/content/xdoc/releases/release.xml
Date Sat, 23 Mar 2013 20:13:36 GMT
Author: bodewig
Date: Sat Mar 23 20:13:35 2013
New Revision: 1460220

URL: http://svn.apache.org/r1460220
Log:
Adapt post-release instructions for svnpubsub and Nexus

Modified:
    commons/cms-site/trunk/content/xdoc/releases/release.xml

Modified: commons/cms-site/trunk/content/xdoc/releases/release.xml
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/releases/release.xml?rev=1460220&r1=1460219&r2=1460220&view=diff
==============================================================================
--- commons/cms-site/trunk/content/xdoc/releases/release.xml (original)
+++ commons/cms-site/trunk/content/xdoc/releases/release.xml Sat Mar 23 20:13:35 2013
@@ -40,10 +40,11 @@
     <ul>
       <li>
         The signed release candidate source and binary distributions and release notes are
available
-        in ~/public_html/commons-foo-1.2-RC3.
+        in https://dist.apache.org/repos/dist/dev/commons/foo.
       </li>
       <li>
-        The maven artifacts associated with the release are available in ~/public_html/commons-foo-1.2-RC3/maven.
+        The maven artifacts associated with the release are available in a closed Nexus staging
+        repository.
       </li>
     </ul>
     </p>
@@ -51,31 +52,35 @@
 
   <subsection name='1 Move Releases Into Distribution Directories'>
     <p>
-    On people.apache.org, change directory to the distribution directory for your component:
-    <pre>
-      cd /www/www.apache.org/dist/commons/foo/ </pre>
-    </p>
-    <p>
-    Move source distributions, their detached signatures and md5 sums into position. 
-    All source versions live in the <em>source</em> subdirectory.
-    <pre>
-      mv ~/public_html/foo-1.2-RC3/commons-foo-1.2-src* source </pre>
-    </p>
-    <p>
-    Move the binary distributions, their detached signatures and md5 sums into position.

-    All binary versions live in the <em>binaries</em> subdirectory.
-    [Note: the source must have been moved already, otherwise the following command will
-    also be applied to the source files.]
-    <pre>
-      mv ~/public_html/foo-1.2-RC3/commons-foo-1.2* binaries </pre>
-    </p>
-    <p>
-    Double check the permissions for both binaries and source distributions.
-    The file permissions should be "-rw-rw-r--" and the group should be "commons", for example:
-    <pre>
-      -rw-rw-r--  1 userid   commons     203 Feb 21 23:45 commons-foo-1.2-src.tar.gz.asc
+      The distribution area of commons releases is populated from
+      <a href="https://dist.apache.org/repos/dist/release/commons/">https://dist.apache.org/repos/dist/release/commons/</a>
+      via svnpubsub.  In order to publish the release, you must move the distributions files
+      from <code>dev</code> to <code>release</code>.
+    </p>
+    <p>You can perform multiple <code>svn mv</code> operations (with or
without local
+      working copies) or you can use <a href="http://svnbook.red-bean.com/en/1.8/svn.ref.svnmucc.re.html">svnmucc</a>,
+      for example:</p>
+    <pre>
+      svnmucc -U https://dist.apache.org/repos/dist \
+          mv dev/commons/foo/RELEASE-NOTES.txt release/commons/foo \
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.asc release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.md5 release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.tar.gz.asc release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.asc release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.md5 release/commons/foo/binaries
\
+          mv dev/commons/foo/binaries/commons-foo-1.2-bin.zip.asc release/commons/foo/binaries
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.asc release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.md5 release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.tar.gz.asc release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip release/commons/foo/source \
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.asc release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.md5 release/commons/foo/source
\
+          mv dev/commons/foo/source/commons-foo-1.2-src.zip.asc release/commons/foo/source
\
+          -m "Publish commons-foo 1.2 Release"
     </pre>
-    </p>
   </subsection>
 
   <subsection name='2 Update Release Directory'>
@@ -86,14 +91,12 @@
     If this document is not present, then copy one from an existing release directory
     and edit that.
     </p>
+    <p>The README must be https://dist.apache.org/repos/dist/release/commons/foo/README.html</p>
     <p>
     Update the latest release number. Please also read through and correct any mistakes you
find
     and fix other items (eg. urls) which need updating. 
     </p>
     <p>
-    Copy the revised <code>README.html</code> into the binary and source directories,
replacing any old versions.
-    </p>
-    <p>
     <a name='Check KEYS file'/>
     <strong>Check KEYS file</strong><br/>
     Check the <code>KEYS</code> file located in the main release directory. This
should contain all the 
@@ -101,85 +104,22 @@
     that it contains the public key you've used to sign these releases. The <code>KEYS</code>
file 
     gives instructions on how to do this.
     </p>
-    <p>
-    <strong>Symbolic Links</strong><br/>
-    These are no longer to be used, so please
-    <a href="http://www.apache.org/dev/mirror-step-by-step.html#symbolic_links">do
not use symbolic links in mirrored directories!</a>
-    <strong>Update RELEASE-NOTES</strong><br/>
-    Replace the current <code>RELEASE-NOTES.txt</code> with the new release notes.
-    <pre>
-    mv ~/public_html/foo-1.2-RC3/RELEASE-NOTES.txt .
-    </pre>
-    </p>
   </subsection>
 
   <subsection name='3 Deploy Maven Artifacts'>
-    <p>
-    Download maven-metadata.xml for commons foo from repo1.maven.org.  This file is located
in the top-level
-    directory for the component.  The file should contain a <code>versioning</code>
element, similar to the following:
-    <pre>
-    &lt;versioning&gt;
-      &lt;release&gt;1.1&lt;/release&gt;
-      &lt;versions&gt;
-        &lt;version&gt;1.0&lt;/version&gt;
-        &lt;version&gt;1.1&lt;/version&gt;
-      &lt;/versions&gt;
-      &lt;lastUpdated&gt;20091011214529&lt;/lastUpdated&gt;
-    &lt;/versioning&gt; </pre>
-    </p>
-    <p>
-    Create a <code>version</code> element for 1.2, update the <code>release</code>
version and update
-    the date in the <code>lastUpdated</code> element:
-    <pre>
-    &lt;versioning&gt;
-      &lt;release&gt;1.2&lt;/release&gt;
-      &lt;versions&gt;
-        &lt;version&gt;1.0&lt;/version&gt;
-        &lt;version&gt;1.1&lt;/version&gt;
-        &lt;version&gt;1.2&lt;/version&gt;
-      &lt;/versions&gt;
-      &lt;lastUpdated&gt;20100401214529&lt;/lastUpdated&gt;
-    &lt;/versioning&gt; </pre>
-    </p>
-    <p>
-    Create the hash files, maven-metadata.xml.sha1 and maven-metadata.xml.md5 for the updated
metadata file.
-    If you do not have openssl or another suitable utility installed locally, you can upload
the edited
-    maven-metadata.xml file to people.apache.org and use the following commands to create
these files:
-    <pre>
-    md5 -q maven-metadata.xml > maven-metadata.xml.md5
-    sha1 -q maven-metadata.xml > maven-metadata.xml.sha1 </pre>
-    </p>
-    <p>
-    Your Maven artifacts (jar and pom files with hashes and signatures) should be placed
in 
-    <code>/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2/</code>
on
-    people.apache.org. This assumes that your component has been migrated to use the org.apache.commons
groupId.
-    If the component still uses commons-foo as its groupId, the deployment location should
be
-    /www/people.apache.org/repo/m2-ibiblio-rsync-repository/commons-foo/commons-foo/1.2.
 If your RC directory
-    includes a "maven" subdirectory including the maven artifacts, you can move the maven
artifacts using 
-    the following commands (assuming the org.apache.commons groupId):
-    <pre>
-    mkdir /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2
-    chgrp commons ~/public_html/foo-1.2-RC3/maven/*
-    chmod g+w ~/public_html/foo-1.2-RC3/maven/*
-    mv ~/public_html/foo-1.2-RC3/maven/* /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo/1.2
</pre>
-    </p>
-    <p>
-    Double-check permissions on the newly created directory and the deployed files.  Also
double-check that all
-    of the artifacts have hashes and signature files associated with them.
-    </p>
-    <p>
-    The updated <code>maven-metadata.xml</code> and its sha1 and md5 hashes should
be placed in the directory
-    above the deployed artifacts 
-    (<code>/www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/commons/commons-foo</code>
if
-    org.apache.commons is the groupId).
-    </p>
+    <p>Login to the Nexus web interface, select your staging repository and
+      <a href="http://www.apache.org/dev/publishing-maven-artifacts.html#promote">promote</a>
it.</p>
     <p>
     The files placed here will be mirrored (after some delay) to the public distribution
     repository on <a href="http://repo1.maven.org/maven2/">http://repo1.maven.org/maven2/</a>.
     </p>
   </subsection>
 
-  <subsection name='4 Test Main Site Downloads'>
+  <subsection name="4 Create Subversion Tag for the Final Release">
+    <p>Copy the release candidate tag in subversion to a name without RC in its name.</p>
+  </subsection>
+  
+  <subsection name='5 Test Main Site Downloads'>
     <p>
     Wait until the release files are available from the main Apache web site 
     (<code>http://www.apache.org/dist/commons/foo/</code>), then confirm things
are good.
@@ -207,7 +147,7 @@
     </p>
   </subsection>
 
-  <subsection name="5 Update Component Build and Website">
+  <subsection name="6 Update Component Build and Website">
     <ul>
     <li>
     <strong>Update trunk version</strong>
@@ -223,7 +163,7 @@
     </ul>
   </subsection>
 
-  <subsection name='6 Create Announcements'>
+  <subsection name='7 Create Announcements'>
     <p>
     Announce the availability of the new release. 
     </p>
@@ -237,7 +177,7 @@
     <ol>
     <li>The release artifacts are available on the mirrors.</li>
     <li>The component website including the updated download page has been updated
on the public site
-        http://commons.apache.org/foo.</li>
+      http://commons.apache.org/proper/foo.</li>
     <li>If the component publishes maven artifacts, these artifacts have been replicated
to the central
         maven repo at repo1.maven.org. (Clear your local repo of the release artifacts and
either activate
         the clirr report with the updated version info or update a local project with a dependency
to the new
@@ -255,7 +195,7 @@
     </p>
   </subsection>
 
-  <subsection name='7 Post Release Cleanup'>
+  <subsection name='8 Post Release Cleanup'>
     <p>
     That's it! The release is out there - but there is still some tidying up to be done.
     </p>
@@ -265,9 +205,10 @@
     Unless old versions are especially required, remove them from the dist directory. This

     will cause the files to also be deleted from the mirrors and
     save them some diskspace as well as simplifying things for users. 
-    Note that the contents of the /www/www.apache.org/dist directory is regularly copied
to
-    /www/archive.apache.org/dist and from there transferred to host archive.apache.org.
-    Deleting files from the standard distribution directories does <i>not</i>
delete
+      Note that the contents of the http://www.apache.org/dist directory is regularly copied
to
+      http://archive.apache.org/dist.
+    Deleting files from the standard distribution directories
+      on https://dist.apache.org/repos/dist/release/commons/ does <i>not</i>
delete
     them from the archive dist directories so users will
     still be able to access old files even when they are not available from the mirrors.
     </li>
@@ -281,7 +222,7 @@
     <li>
     <strong>Update DOAP file</strong>
     Update the component's <a href="http://projects.apache.org/guidelines.html">DOAP
file</a>
-    with details of the released version:
+    and add a new entry with details of the released version:
     <pre>
       &lt;release&gt;
         &lt;Version&gt;



Mime
View raw message