You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@archiva.apache.org by sk...@apache.org on 2015/06/26 11:39:56 UTC
svn commit: r1687731 [3/15] - in /archiva/site-content: ./ css/ developers/
errors/ fonts/ js/ jsui/
Modified: archiva/site-content/developers/publishing-site.html
URL: http://svn.apache.org/viewvc/archiva/site-content/developers/publishing-site.html?rev=1687731&r1=1687730&r2=1687731&view=diff
==============================================================================
--- archiva/site-content/developers/publishing-site.html (original)
+++ archiva/site-content/developers/publishing-site.html Fri Jun 26 09:39:55 2015
@@ -1,283 +1,324 @@
-<!DOCTYPE html>
-<!--
- | Generated by Apache Maven Doxia
- | Rendered using Apache Maven Fluido Skin 1.4
--->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
- <head>
- <meta charset="UTF-8" />
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20150625" />
- <meta http-equiv="Content-Language" content="en" />
- <title>Archiva – Archiva Sites Publishing</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.4.min.css" />
- <link rel="stylesheet" href="../css/site.css" />
- <link rel="stylesheet" href="../css/print.css" media="print" />
-
-
- <script type="text/javascript" src="../js/apache-maven-fluido-1.4.min.js"></script>
-
-
-
-<script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
-
-
-<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
- pageTracker._initData();
- pageTracker._trackPageview();</script>
-
- </head>
- <body class="topBarEnabled">
-
-
-
-
-
- <div id="topbar" class="navbar navbar-fixed-top ">
- <div class="navbar-inner">
- <div class="container"><div class="nav-collapse">
-
-
- <ul class="nav">
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Introduction <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="../index.html" title="About">About</a>
-</li>
-
- <li> <a href="../download.html" title="Downloads">Downloads</a>
-</li>
-
- <li> <a href="../versions.html" title="Versions">Versions</a>
-</li>
-
- <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
-</li>
-
- <li> <a href="../security.html" title="Security">Security</a>
-</li>
-
- <li class="dropdown-submenu">
- <a href="../" title="Documentation">Documentation</a>
- <ul class="dropdown-menu">
- <li> <a href="../docs/2.2.0/" title="Release 2.2.0">Release 2.2.0</a>
-</li>
- <li> <a href="../docs/1.3.9/" title="Preview 1.3.9">Preview 1.3.9</a>
-</li>
- <li> <a href="../docs/2.2.1-SNAPSHOT/" title="Dev 2.2.1-SNAPSHOT">Dev 2.2.1-SNAPSHOT</a>
-</li>
- </ul>
- </li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="../developers/building.html" title="Build Apache Archiva">Build Apache Archiva</a>
-</li>
-
- <li> <a href="../get-involved.html" title="Get involved">Get involved</a>
-</li>
-
- <li> <a href="../developers/how-we-do-things.html" title="How we do things">How we do things</a>
-</li>
-
- <li> <a href="../redback" title="Redback">Redback</a>
-</li>
-
- <li> <a href="../redback/components" title="Redback Components">Redback Components</a>
-</li>
-
- <li class="dropdown-submenu">
- <a href="../jsui/index.html" title="Javascript application Architecture">Javascript application Architecture</a>
- <ul class="dropdown-menu">
- <li> <a href="../jsui/rest.html" title="Rest service">Rest service</a>
-</li>
- <li> <a href="../jsui/template-loading.html" title="JS Template loading">JS Template loading</a>
-</li>
- <li> <a href="../jsui/i18n.html" title="i18n">i18n</a>
-</li>
- <li> <a href="../jsui/knockout-binding.html" title="Knockout Binding">Knockout Binding</a>
-</li>
- <li> <a href="../jsui/generics-js.html" title="Generic Javascipts">Generic Javascipts</a>
-</li>
- </ul>
- </li>
-
- <li> <a href="../developers/releasing.html" title="Releasing">Releasing</a>
-</li>
-
- <li> <a href="../developers/publishing-site.html" title="Site Publish">Site Publish</a>
-</li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
-</li>
- </ul>
- </li>
- </ul>
-
- <form id="search-form" action="https://www.google.com/search" method="get" class="navbar-search pull-right" >
-
- <input value="http://archiva.apache.org/" name="sitesearch" type="hidden"/>
- <input class="search-query" name="q" id="query" type="text" />
-</form>
-<script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=search-form"></script>
-
-
-
- </div>
-
- </div>
- </div>
- </div>
-
- <div class="container">
- <div id="banner">
- <div class="pull-left">
- <div id="bannerLeft">
- <h2>Archiva</h2>
- </div>
- </div>
- <div class="pull-right"> </div>
- <div class="clear"><hr/></div>
- </div>
-
- <div id="breadcrumbs">
- <ul class="breadcrumb">
-
-
- <li id="publishDate">Last Published: 2015-06-25
- <span class="divider">|</span>
- </li>
- <li id="projectVersion">Version: 1-SNAPSHOT
- </li>
-
-
-
-
- </ul>
- </div>
-
-
-
- <div id="bodyColumn" >
-
- <div class="section">
-<h2><a name="Publishing_the_Archiva_Site"></a>Publishing the Archiva Site</h2>
-<p>The Archiva site, documentation and reference documentation are now published to <tt>http://archiva.apache.org/</tt> using the <a class="externalLink" href="http://www.apache.org/dev/project-site.html#svnpubsub"> ASF's svnpubsub</a> service.</p>
-<p>The files published to the site are all stored under the Subversion repository at <a class="externalLink" href="http://svn.apache.org/repos/asf/archiva/site-content/">http://svn.apache.org/repos/asf/archiva/site-content/</a>.</p>
-<p>This mostly operates like a normal site deployment, though there are some specific customisations and special instructions for the reference library. The processes follow those described for the <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/">Maven SCM Publish Plugin</a> for <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/examples/one-module-configuration.html"> Single module projects</a> and <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/examples/multi-module-configuration.html"> Multi-module projects</a> as applicable.</p>
-<p>Each site checks out the production site data into the <tt>site-publish</tt> directory of the current project, to avoid being cleaned as part of the build. It is ignored by <tt>svn</tt> operations, but you should ensure that the checkout is clean if you ever cancel or have a failure during a publish operation. You can check it is clean by ensuring there is no data from <tt>git status</tt> in that directory, or by removing it and having it get checked out again.</p>
-<div class="section">
-<h3><a name="Editing_and_Publishing_the_Main_Site"></a>Editing and Publishing the Main Site</h3>
-<p>The site displayed at the root of <a class="externalLink" href="http://archiva.apache.org">http://archiva.apache.org</a> (where you are reading this) has its source code in Git at <a class="externalLink" href="https://git-wip-us.apache.org/repos/asf/archiva-site.git">https://git-wip-us.apache.org/repos/asf/archiva-site.git</a>.</p>
-<p>To edit and publish the site, do the following:</p>
-<ol style="list-style-type: decimal">
-<li>Checkout the source code from Git (if you follow the instructions in <a href="./building.html"> Building Archiva</a>, you know how to have it.</li>
-<li>Make edits and check them using <tt>mvn site</tt> or <tt>mvn site:run</tt> until satisfied.</li>
-<li>Commit your changes (making sure your working copy is completely up to date first)</li>
-<li>Publish the site:
-<div>
-<pre>mvn site-deploy
-</pre></div></li></ol>
-<p>This site deployment can be done at any time, and is not tied to releases.</p>
-<p>Note that since the main site also contains the (large!) <tt>docs</tt> and <tt>ref</tt> directories in the <tt>site-publish</tt> directory, there is a special <tt>setup-checkout</tt> profile in place to get the initial checkout without those directories. This will normally be activated whenever the <tt>site-publish</tt> directory is missing - if you happen to have active profiles from your <tt>settings.xml</tt> you may need to enable it explicitly whenever you do a deployment and that checkout is missing: <tt>mvn site-deploy -Psetup-checkout</tt> </p></div>
-<div class="section">
-<h3><a name="Editing_and_Publishing_the_Archiva_Documentation"></a>Editing and Publishing the Archiva Documentation</h3>
-<p>The documentation displayed under the subdirectories of <a class="externalLink" href="http://archiva.apache.org/docs/">http://archiva.apache.org/docs/</a> has its source code in Git at <a class="externalLink" href="https://git-wip-us.apache.org/repos/asf/archiva.git">https://git-wip-us.apache.org/repos/asf/archiva.git</a> directory archiva-docs, which is part of the main project checkout.</p>
-<p>The instructions for managing the documentation is the same as for the main site, being published from the directory using:</p>
-<div>
-<pre>mvn site-deploy
-</pre></div>
-<p>However, in this case it is typically done as part of a release process - see <a href="./releasing.html"> Releasing Archiva</a> for instructions on doing this.</p>
-<p>The documentation remains versioned based on the release it is related to. To best manage this with svnpubsub, the site is always published into a directory <tt>docs/latest</tt>, only requiring a small number of modifications to be made. Then, as part of the release instructions, the <tt>latest</tt> directory is copied to the versioned location - for example, <tt>http://svn.apache.org/repos/asf/archiva/site-content/docs/1.4-M4</tt>.</p>
-<p>For <tt>site:stage</tt> to apply correctly without needing a full checkout, a workaround is applied by setting the <tt>distributionManagement/site/url</tt> element to match that of the parent site. The value is then overridden with the correct value in the <tt>maven-scm-publish-plugin</tt> configuration. This avoids the Site plugin attempting to relativize links incorrectly.</p></div>
-<div class="section">
-<h3><a name="Editing_and_Publishing_the_Reference_Documentation"></a>Editing and Publishing the Reference Documentation</h3>
-<p>The reference documentation, including JavaDocs and source cross-reference, is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/ref">http://archiva.apache.org/ref</a>. At this time, only the latest reference documents are retained. They require quite a lot of space, and historical information is of less relevance to Archiva developers or users.</p>
-<p>To publish the latest reference documents, you need to run:</p>
-<div>
-<pre>cd archiva-modules
-mvn site site:stage scm-publish:publish-scm
-or
-sh ./deploySite.sh
-</pre></div>
-<p>This will likely cause a very large commit, and should be done infrequently. Once per release is likely to be adequate.</p></div>
-<div class="section">
-<h3><a name="Publishing_Redback_site"></a>Publishing Redback site</h3>
-<p>The redback is stored under the Subversion repository at <a class="externalLink" href="https://svn.apache.org/repos/asf/archiva/redback/redback-site/trunk">https://svn.apache.org/repos/asf/archiva/redback/redback-site/trunk</a>.</p>
-<p>It's displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback">http://archiva.apache.org/redback</a>.</p>
-<p>To publish documentation, you need to run:</p>
-<div>
-<pre>mvn site-deploy
-</pre></div></div>
-<div class="section">
-<h3><a name="Publishing_Redback_Core_reference"></a>Publishing Redback Core reference</h3>
-<p>The Redback core reference is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback/core">http://archiva.apache.org/redback/core</a>.</p>
-<p>It contains javadoc for Redback core.</p>
-<p>To publish documentation, you need to run:</p>
-<div>
-<pre>mvn clean site-deploy scm-publish:publish-scm
-or
-sh ./deploySite.sh
-</pre></div></div>
-<div class="section">
-<h3><a name="Publishing_Redback_Components_reference"></a>Publishing Redback Components reference</h3>
-<p>The Redback components reference is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback/components">http://archiva.apache.org/redback/components</a>.</p>
-<p>It contains javadoc for Redback components.</p>
-<p>To publish documentation, you need to run:</p>
-<div>
-<pre>mvn clean site-deploy scm-publish:publish-scm
-or
-sh ./deploySite.sh
-</pre></div></div></div>
- </div>
- </div>
-
- <hr/>
-
- <footer>
- <div class="container">
- <div class="row">
-
-<div class="row pull-left">Apache Archiva, Archiva, Apache, the Apache feather logo, and the Apache Archiva project logos are trademarks of The Apache Software Foundation.</div>
-
-<div class="row pull-left">
- <a href="http://archiva.apache.org/privacy-policy.html">Privacy Policy</a>
-</div>
- </div>
-
- <p id="poweredBy" class="pull-right">
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
- </a>
- </p>
-
-
-
-
-
- <div id="ohloh" class="pull-right">
- <script type="text/javascript" src="https://www.ohloh.net/p/6670/widgets/project_basic_stats.js"></script>
- </div>
- </div>
- </footer>
- </body>
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.4
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20150625" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Archiva – Archiva Sites Publishing</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.4.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="../js/apache-maven-fluido-1.4.min.js"></script>
+
+
+
+<script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
+
+
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+ pageTracker._initData();
+ pageTracker._trackPageview();</script>
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-140879-5']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container"><div class="nav-collapse">
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Introduction <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="../index.html" title="About">About</a>
+</li>
+
+ <li> <a href="../download.html" title="Downloads">Downloads</a>
+</li>
+
+ <li> <a href="../versions.html" title="Versions">Versions</a>
+</li>
+
+ <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="../security.html" title="Security">Security</a>
+</li>
+
+ <li class="dropdown-submenu">
+ <a href="../" title="Documentation">Documentation</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../docs/2.2.0/" title="Release 2.2.0">Release 2.2.0</a>
+</li>
+ <li> <a href="../docs/1.3.9/" title="Preview 1.3.9">Preview 1.3.9</a>
+</li>
+ <li> <a href="../docs/2.2.1-SNAPSHOT/" title="Dev 2.2.1-SNAPSHOT">Dev 2.2.1-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="../developers/building.html" title="Build Apache Archiva">Build Apache Archiva</a>
+</li>
+
+ <li> <a href="../get-involved.html" title="Get involved">Get involved</a>
+</li>
+
+ <li> <a href="../developers/how-we-do-things.html" title="How we do things">How we do things</a>
+</li>
+
+ <li> <a href="../redback" title="Redback">Redback</a>
+</li>
+
+ <li> <a href="../redback/components" title="Redback Components">Redback Components</a>
+</li>
+
+ <li class="dropdown-submenu">
+ <a href="../jsui/index.html" title="Javascript application Architecture">Javascript application Architecture</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../jsui/rest.html" title="Rest service">Rest service</a>
+</li>
+ <li> <a href="../jsui/template-loading.html" title="JS Template loading">JS Template loading</a>
+</li>
+ <li> <a href="../jsui/i18n.html" title="i18n">i18n</a>
+</li>
+ <li> <a href="../jsui/knockout-binding.html" title="Knockout Binding">Knockout Binding</a>
+</li>
+ <li> <a href="../jsui/generics-js.html" title="Generic Javascipts">Generic Javascipts</a>
+</li>
+ </ul>
+ </li>
+
+ <li> <a href="../developers/releasing.html" title="Releasing">Releasing</a>
+</li>
+
+ <li> <a href="../developers/publishing-site.html" title="Site Publish">Site Publish</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="../license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="../team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="../source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ <form id="search-form" action="https://www.google.com/search" method="get" class="navbar-search pull-right" >
+
+ <input value="http://archiva.apache.org/" name="sitesearch" type="hidden"/>
+ <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=search-form"></script>
+
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="../index.html" id="bannerLeft">
+ <img src="../images/archiva.png" alt="Apache Archiva"/>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://www.apache.org/" id="bannerRight">
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="">
+ <a href="../" title="Archiva">
+ Archiva</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Archiva Sites Publishing</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 25 Jun 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <div class="section">
+<h2><a name="Publishing_the_Archiva_Site"></a>Publishing the Archiva Site</h2>
+<p>The Archiva site, documentation and reference documentation are now published to <tt>http://archiva.apache.org/</tt> using the <a class="externalLink" href="http://www.apache.org/dev/project-site.html#svnpubsub"> ASF's svnpubsub</a> service.</p>
+<p>The files published to the site are all stored under the Subversion repository at <a class="externalLink" href="http://svn.apache.org/repos/asf/archiva/site-content/">http://svn.apache.org/repos/asf/archiva/site-content/</a>.</p>
+<p>This mostly operates like a normal site deployment, though there are some specific customisations and special instructions for the reference library. The processes follow those described for the <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/">Maven SCM Publish Plugin</a> for <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/examples/one-module-configuration.html"> Single module projects</a> and <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/examples/multi-module-configuration.html"> Multi-module projects</a> as applicable.</p>
+<p>Each site checks out the production site data into the <tt>site-publish</tt> directory of the current project, to avoid being cleaned as part of the build. It is ignored by <tt>svn</tt> operations, but you should ensure that the checkout is clean if you ever cancel or have a failure during a publish operation. You can check it is clean by ensuring there is no data from <tt>git status</tt> in that directory, or by removing it and having it get checked out again.</p>
+<div class="section">
+<h3><a name="Editing_and_Publishing_the_Main_Site"></a>Editing and Publishing the Main Site</h3>
+<p>The site displayed at the root of <a class="externalLink" href="http://archiva.apache.org">http://archiva.apache.org</a> (where you are reading this) has its source code in Git at <a class="externalLink" href="https://git-wip-us.apache.org/repos/asf/archiva-site.git">https://git-wip-us.apache.org/repos/asf/archiva-site.git</a>.</p>
+<p>To edit and publish the site, do the following:</p>
+<ol style="list-style-type: decimal">
+<li>Checkout the source code from Git (if you follow the instructions in <a href="./building.html"> Building Archiva</a>, you know how to have it.</li>
+<li>Make edits and check them using <tt>mvn site</tt> or <tt>mvn site:run</tt> until satisfied.</li>
+<li>Commit your changes (making sure your working copy is completely up to date first)</li>
+<li>Publish the site:
+<div>
+<pre>mvn site-deploy</pre></div></li></ol>
+<p>This site deployment can be done at any time, and is not tied to releases.</p>
+<p>Note that since the main site also contains the (large!) <tt>docs</tt> and <tt>ref</tt> directories in the <tt>site-publish</tt> directory, there is a special <tt>setup-checkout</tt> profile in place to get the initial checkout without those directories. This will normally be activated whenever the <tt>site-publish</tt> directory is missing - if you happen to have active profiles from your <tt>settings.xml</tt> you may need to enable it explicitly whenever you do a deployment and that checkout is missing: <tt>mvn site-deploy -Psetup-checkout</tt> </p></div>
+<div class="section">
+<h3><a name="Editing_and_Publishing_the_Archiva_Documentation"></a>Editing and Publishing the Archiva Documentation</h3>
+<p>The documentation displayed under the subdirectories of <a class="externalLink" href="http://archiva.apache.org/docs/">http://archiva.apache.org/docs/</a> has its source code in Git at <a class="externalLink" href="https://git-wip-us.apache.org/repos/asf/archiva.git">https://git-wip-us.apache.org/repos/asf/archiva.git</a> directory archiva-docs, which is part of the main project checkout.</p>
+<p>The instructions for managing the documentation is the same as for the main site, being published from the directory using:</p>
+<div>
+<pre>mvn site-deploy</pre></div>
+<p>However, in this case it is typically done as part of a release process - see <a href="./releasing.html"> Releasing Archiva</a> for instructions on doing this.</p>
+<p>The documentation remains versioned based on the release it is related to. To best manage this with svnpubsub, the site is always published into a directory <tt>docs/latest</tt>, only requiring a small number of modifications to be made. Then, as part of the release instructions, the <tt>latest</tt> directory is copied to the versioned location - for example, <tt>http://svn.apache.org/repos/asf/archiva/site-content/docs/1.4-M4</tt>.</p>
+<p>For <tt>site:stage</tt> to apply correctly without needing a full checkout, a workaround is applied by setting the <tt>distributionManagement/site/url</tt> element to match that of the parent site. The value is then overridden with the correct value in the <tt>maven-scm-publish-plugin</tt> configuration. This avoids the Site plugin attempting to relativize links incorrectly.</p></div>
+<div class="section">
+<h3><a name="Editing_and_Publishing_the_Reference_Documentation"></a>Editing and Publishing the Reference Documentation</h3>
+<p>The reference documentation, including JavaDocs and source cross-reference, is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/ref">http://archiva.apache.org/ref</a>. At this time, only the latest reference documents are retained. They require quite a lot of space, and historical information is of less relevance to Archiva developers or users.</p>
+<p>To publish the latest reference documents, you need to run:</p>
+<div>
+<pre>cd archiva-modules
+mvn site site:stage scm-publish:publish-scm
+or
+sh ./deploySite.sh</pre></div>
+<p>This will likely cause a very large commit, and should be done infrequently. Once per release is likely to be adequate.</p></div>
+<div class="section">
+<h3><a name="Publishing_Redback_site"></a>Publishing Redback site</h3>
+<p>The redback is stored under the Subversion repository at <a class="externalLink" href="https://svn.apache.org/repos/asf/archiva/redback/redback-site/trunk">https://svn.apache.org/repos/asf/archiva/redback/redback-site/trunk</a>.</p>
+<p>It's displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback">http://archiva.apache.org/redback</a>.</p>
+<p>To publish documentation, you need to run:</p>
+<div>
+<pre>mvn site-deploy</pre></div></div>
+<div class="section">
+<h3><a name="Publishing_Redback_Core_reference"></a>Publishing Redback Core reference</h3>
+<p>The Redback core reference is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback/core">http://archiva.apache.org/redback/core</a>.</p>
+<p>It contains javadoc for Redback core.</p>
+<p>To publish documentation, you need to run:</p>
+<div>
+<pre>mvn clean site-deploy scm-publish:publish-scm
+or
+sh ./deploySite.sh</pre></div></div>
+<div class="section">
+<h3><a name="Publishing_Redback_Components_reference"></a>Publishing Redback Components reference</h3>
+<p>The Redback components reference is displayed under the URL <a class="externalLink" href="http://archiva.apache.org/redback/components">http://archiva.apache.org/redback/components</a>.</p>
+<p>It contains javadoc for Redback components.</p>
+<p>To publish documentation, you need to run:</p>
+<div>
+<pre>mvn clean site-deploy scm-publish:publish-scm
+or
+sh ./deploySite.sh</pre></div></div></div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+
+<div class="row pull-left">Apache Archiva, Archiva, Apache, the Apache feather logo, and the Apache Archiva project logos are trademarks of The Apache Software Foundation.</div>
+
+<div class="row pull-left">
+ <a href="http://archiva.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+ </div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="https://www.ohloh.net/p/6670/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
</html>
\ No newline at end of file
Modified: archiva/site-content/developers/releasing.html
URL: http://svn.apache.org/viewvc/archiva/site-content/developers/releasing.html?rev=1687731&r1=1687730&r2=1687731&view=diff
==============================================================================
--- archiva/site-content/developers/releasing.html (original)
+++ archiva/site-content/developers/releasing.html Fri Jun 26 09:39:55 2015
@@ -1,272 +1,314 @@
-<!DOCTYPE html>
-<!--
- | Generated by Apache Maven Doxia
- | Rendered using Apache Maven Fluido Skin 1.4
--->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
- <head>
- <meta charset="UTF-8" />
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Creation-yyyymmdd" content="20120119" />
- <meta name="Date-Revision-yyyymmdd" content="20150625" />
- <meta http-equiv="Content-Language" content="en" />
- <title>Archiva – Archiva release process</title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.4.min.css" />
- <link rel="stylesheet" href="../css/site.css" />
- <link rel="stylesheet" href="../css/print.css" media="print" />
-
-
- <script type="text/javascript" src="../js/apache-maven-fluido-1.4.min.js"></script>
-
-
-
-<script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
-
-
-<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
- pageTracker._initData();
- pageTracker._trackPageview();</script>
-
- </head>
- <body class="topBarEnabled">
-
-
-
-
-
- <div id="topbar" class="navbar navbar-fixed-top ">
- <div class="navbar-inner">
- <div class="container"><div class="nav-collapse">
-
-
- <ul class="nav">
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Introduction <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="../index.html" title="About">About</a>
-</li>
-
- <li> <a href="../download.html" title="Downloads">Downloads</a>
-</li>
-
- <li> <a href="../versions.html" title="Versions">Versions</a>
-</li>
-
- <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
-</li>
-
- <li> <a href="../security.html" title="Security">Security</a>
-</li>
-
- <li class="dropdown-submenu">
- <a href="../" title="Documentation">Documentation</a>
- <ul class="dropdown-menu">
- <li> <a href="../docs/2.2.0/" title="Release 2.2.0">Release 2.2.0</a>
-</li>
- <li> <a href="../docs/1.3.9/" title="Preview 1.3.9">Preview 1.3.9</a>
-</li>
- <li> <a href="../docs/2.2.1-SNAPSHOT/" title="Dev 2.2.1-SNAPSHOT">Dev 2.2.1-SNAPSHOT</a>
-</li>
- </ul>
- </li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="../developers/building.html" title="Build Apache Archiva">Build Apache Archiva</a>
-</li>
-
- <li> <a href="../get-involved.html" title="Get involved">Get involved</a>
-</li>
-
- <li> <a href="../developers/how-we-do-things.html" title="How we do things">How we do things</a>
-</li>
-
- <li> <a href="../redback" title="Redback">Redback</a>
-</li>
-
- <li> <a href="../redback/components" title="Redback Components">Redback Components</a>
-</li>
-
- <li class="dropdown-submenu">
- <a href="../jsui/index.html" title="Javascript application Architecture">Javascript application Architecture</a>
- <ul class="dropdown-menu">
- <li> <a href="../jsui/rest.html" title="Rest service">Rest service</a>
-</li>
- <li> <a href="../jsui/template-loading.html" title="JS Template loading">JS Template loading</a>
-</li>
- <li> <a href="../jsui/i18n.html" title="i18n">i18n</a>
-</li>
- <li> <a href="../jsui/knockout-binding.html" title="Knockout Binding">Knockout Binding</a>
-</li>
- <li> <a href="../jsui/generics-js.html" title="Generic Javascipts">Generic Javascipts</a>
-</li>
- </ul>
- </li>
-
- <li> <a href="../developers/releasing.html" title="Releasing">Releasing</a>
-</li>
-
- <li> <a href="../developers/publishing-site.html" title="Site Publish">Site Publish</a>
-</li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
-</li>
-
- <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
-</li>
- </ul>
- </li>
- </ul>
-
- <form id="search-form" action="https://www.google.com/search" method="get" class="navbar-search pull-right" >
-
- <input value="http://archiva.apache.org/" name="sitesearch" type="hidden"/>
- <input class="search-query" name="q" id="query" type="text" />
-</form>
-<script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=search-form"></script>
-
-
-
- </div>
-
- </div>
- </div>
- </div>
-
- <div class="container">
- <div id="banner">
- <div class="pull-left">
- <div id="bannerLeft">
- <h2>Archiva</h2>
- </div>
- </div>
- <div class="pull-right"> </div>
- <div class="clear"><hr/></div>
- </div>
-
- <div id="breadcrumbs">
- <ul class="breadcrumb">
-
-
- <li id="publishDate">Last Published: 2015-06-25
- <span class="divider">|</span>
- </li>
- <li id="projectVersion">Version: 1-SNAPSHOT
- </li>
-
-
-
-
- </ul>
- </div>
-
-
-
- <div id="bodyColumn" >
-
- <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/guides/mini/guide
-apt-format.html --><div class="section">
-<h2><a name="Archiva_release_process"></a>Archiva release process</h2>
-<ol style="list-style-type: decimal">
-<li>Post to the dev list a few days before you plan to do an Archiva release</li>
-<li>Recreate the staging repository on archiva-repository.apache.org - make sure that it is not scanned (so that .index* is not created). Your maven setting must contains the entry to be able to deploy.
-<div class="source"><pre class="prettyprint"> <server>
- <id>archiva-repository.releases</id>
- <username></username>
- <password></password>
- </server>
-</pre></div></li>
-<li>If there are changes in the parent pom, release parent pom – https://svn.apache.org/repos/asf/archiva/parent
-<ul>
-<li>mvn release:prepare (verify that it has been properly tagged)</li>
-<li>mvn release:perform (verify that it has been deployed correctly in the staging repo)</li></ul></li>
-<li>Update the parent pom version of archiva – https://svn.apache.org/repos/asf/archiva/trunk
-<ul>
-<li>change the parent pom version to the archiva-parent version that has just been released</li>
-<li>commit the changes made</li></ul></li>
-<li>Update the release notes and the site.xml for version changes in archiva-docs</li>
-<li>Verify that the webapp-tests are building successfully. Since it is in a separate profile but inside the Archiva source tree, it will not be released but will still be included in the release tag. If some tests are failing, comment it out first so that only the passing tests are executed when the webapp-tests module are built from the tag.</li>
-<li>Release archiva You should have a GPG agent running (preferred), and confirm it works by running "gpg -ab" (type some text and press Ctrl-D). If you do not have a GPG agent running, make sure that you have the "apache-release" profile set in your settings.xml as shown below.
-<div class="source"><pre class="prettyprint"><profile>
- <id>apache-release</id>
- <properties>
- <gpg.passphrase>[GPG_PASSWORD]</gpg.passphrase>
- </properties>
-</profile>
-</pre></div>
-<p>Set your user credentials for the stage repo in the <i>servers</i> section of your settings.xml for <a href="#archiva-repository.releases">archiva-repository.releases</a>.</p>
-<p>Execute mvn release:prepare (check that it has been properly tagged. the tag name must be.. archiva-[VERSION]).</p>
-<p>Next, execute mvn release:perform</p>
-<p>Download the uploaded files via wget:</p>
-<div class="source"><pre class="prettyprint">ex.
-wget http://archiva-repository.apache.org/archiva/repository/staged-releases/org/apache/archiva/archiva-jetty/1.3/archiva-jetty-1.3-bin.tar.gz
-Verify the signatures:
-ex.
-gpg -v archiva-jetty-1.3-bin.zip.asc
-</pre></div>
-<p>The documentation is deployed as part of the process to the final location for review in the vote: http://archiva.apache.org/docs/1.3/. If the vote doesn't pass, the documentation will need to be removed from the server for redeployment. Commit the sources and binaries from org/apache/archiva/archiva-jetty, and org/apache/archiva/archiva to the svn distribution tree. First in dev tree: https://dist.apache.org/repos/dist/dev/archiva/ (if the vote pass they will be copied to release tree) https://dist.apache.org/repos/dist/release/archiva</p>
-<div class="source"><pre class="prettyprint">svn co https://dist.apache.org/repos/dist/dev/archiva/ archiva-dev-release
-cd archiva-dev-release
-sh ./release-script-svn.sh VERSION STAGING_URL
-</pre></div>
-<p>Call for a vote in the dev list and wait for 72 hrs. for the vote results. 3 binding votes are necessary for the release to be finalized. example If the vote fails or needs to be canceled, the version number should not be re-used if the version was made available for public download. After the vote has passed, move the files from dist dev to dist release: svn mv https://dist.apache.org/repos/dist/dev/archiva/ to https://dist.apache.org/repos/dist/relase/archiva/ To sync the jars to ibiblio, execute:</p>
-<p><b>NOTE: the stage plugin doesn't work with maven3 you must use maven 2.2.1</b></p>
-<div class="source"><pre class="prettyprint"> mvn stage:copy -Dsource="https://archiva-repository.apache.org/archiva/repository/archiva-releases-stage/"
- -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
- -Dversion=1.3 -DrepositoryId=apache.releases
-</pre></div>
-<p>mark the appropriate release version in JIRA as complete Update the archiva site (https://svn.apache.org/repos/asf/archiva/site/) for the versions and release notes URL and run mvn site-deploy. The 3 properties to change are at the bottom of pom.xml before generating the site. Once mirroring done (can be 24H): remove previous versions from https://dist.apache.org/repos/dist/release/archiva/</p>
-<p>Publish the reference docs (sh ./deploySite.sh in the archiva-modules directory) from the release tag. You may have to exclude the archiva-webapp module to do this, and will require MAVEN_OPTS=-Xmx256m. You may need to use Maven 2.2.1 instead of Maven 3.x for this.</p>
-<p>Send out an announcement of the release to:</p>
-<ul>
-<li>users@archiva.apache.org</li>
-<li>users@maven.apache.org</li>
-<li>announce@apache.org</li></ul></li></ol></div>
- </div>
- </div>
-
- <hr/>
-
- <footer>
- <div class="container">
- <div class="row">
-
-<div class="row pull-left">Apache Archiva, Archiva, Apache, the Apache feather logo, and the Apache Archiva project logos are trademarks of The Apache Software Foundation.</div>
-
-<div class="row pull-left">
- <a href="http://archiva.apache.org/privacy-policy.html">Privacy Policy</a>
-</div>
- </div>
-
- <p id="poweredBy" class="pull-right">
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
- </a>
- </p>
-
-
-
-
-
- <div id="ohloh" class="pull-right">
- <script type="text/javascript" src="https://www.ohloh.net/p/6670/widgets/project_basic_stats.js"></script>
- </div>
- </div>
- </footer>
- </body>
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.4
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Creation-yyyymmdd" content="20120119" />
+ <meta name="Date-Revision-yyyymmdd" content="20150625" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Archiva – Archiva release process</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.4.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="../js/apache-maven-fluido-1.4.min.js"></script>
+
+
+
+<script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
+
+
+<script type="text/javascript">var pageTracker = _gat._getTracker("UA-140879-5");
+ pageTracker._initData();
+ pageTracker._trackPageview();</script>
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-140879-5']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container"><div class="nav-collapse">
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Introduction <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="../index.html" title="About">About</a>
+</li>
+
+ <li> <a href="../download.html" title="Downloads">Downloads</a>
+</li>
+
+ <li> <a href="../versions.html" title="Versions">Versions</a>
+</li>
+
+ <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="../security.html" title="Security">Security</a>
+</li>
+
+ <li class="dropdown-submenu">
+ <a href="../" title="Documentation">Documentation</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../docs/2.2.0/" title="Release 2.2.0">Release 2.2.0</a>
+</li>
+ <li> <a href="../docs/1.3.9/" title="Preview 1.3.9">Preview 1.3.9</a>
+</li>
+ <li> <a href="../docs/2.2.1-SNAPSHOT/" title="Dev 2.2.1-SNAPSHOT">Dev 2.2.1-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="../developers/building.html" title="Build Apache Archiva">Build Apache Archiva</a>
+</li>
+
+ <li> <a href="../get-involved.html" title="Get involved">Get involved</a>
+</li>
+
+ <li> <a href="../developers/how-we-do-things.html" title="How we do things">How we do things</a>
+</li>
+
+ <li> <a href="../redback" title="Redback">Redback</a>
+</li>
+
+ <li> <a href="../redback/components" title="Redback Components">Redback Components</a>
+</li>
+
+ <li class="dropdown-submenu">
+ <a href="../jsui/index.html" title="Javascript application Architecture">Javascript application Architecture</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../jsui/rest.html" title="Rest service">Rest service</a>
+</li>
+ <li> <a href="../jsui/template-loading.html" title="JS Template loading">JS Template loading</a>
+</li>
+ <li> <a href="../jsui/i18n.html" title="i18n">i18n</a>
+</li>
+ <li> <a href="../jsui/knockout-binding.html" title="Knockout Binding">Knockout Binding</a>
+</li>
+ <li> <a href="../jsui/generics-js.html" title="Generic Javascipts">Generic Javascipts</a>
+</li>
+ </ul>
+ </li>
+
+ <li> <a href="../developers/releasing.html" title="Releasing">Releasing</a>
+</li>
+
+ <li> <a href="../developers/publishing-site.html" title="Site Publish">Site Publish</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="../license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="../team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="../source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ <form id="search-form" action="https://www.google.com/search" method="get" class="navbar-search pull-right" >
+
+ <input value="http://archiva.apache.org/" name="sitesearch" type="hidden"/>
+ <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=search-form"></script>
+
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="../index.html" id="bannerLeft">
+ <img src="../images/archiva.png" alt="Apache Archiva"/>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://www.apache.org/" id="bannerRight">
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="Apache Software Foundation"/>
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="">
+ <a href="../" title="Archiva">
+ Archiva</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Archiva release process</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 25 Jun 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <!-- 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. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/guides/mini/guide
-apt-format.html --><div class="section">
+<h2><a name="Archiva_release_process"></a>Archiva release process</h2>
+<ol style="list-style-type: decimal">
+<li>Post to the dev list a few days before you plan to do an Archiva release</li>
+<li>Recreate the staging repository on archiva-repository.apache.org - make sure that it is not scanned (so that .index* is not created). Your maven setting must contains the entry to be able to deploy.
+<div class="source"><pre class="prettyprint"> <server>
+ <id>archiva-repository.releases</id>
+ <username></username>
+ <password></password>
+ </server></pre></div></li>
+<li>If there are changes in the parent pom, release parent pom – https://svn.apache.org/repos/asf/archiva/parent
+<ul>
+<li>mvn release:prepare (verify that it has been properly tagged)</li>
+<li>mvn release:perform (verify that it has been deployed correctly in the staging repo)</li></ul></li>
+<li>Update the parent pom version of archiva – https://svn.apache.org/repos/asf/archiva/trunk
+<ul>
+<li>change the parent pom version to the archiva-parent version that has just been released</li>
+<li>commit the changes made</li></ul></li>
+<li>Update the release notes and the site.xml for version changes in archiva-docs</li>
+<li>Verify that the webapp-tests are building successfully. Since it is in a separate profile but inside the Archiva source tree, it will not be released but will still be included in the release tag. If some tests are failing, comment it out first so that only the passing tests are executed when the webapp-tests module are built from the tag.</li>
+<li>Release archiva You should have a GPG agent running (preferred), and confirm it works by running "gpg -ab" (type some text and press Ctrl-D). If you do not have a GPG agent running, make sure that you have the "apache-release" profile set in your settings.xml as shown below.
+<div class="source"><pre class="prettyprint"><profile>
+ <id>apache-release</id>
+ <properties>
+ <gpg.passphrase>[GPG_PASSWORD]</gpg.passphrase>
+ </properties>
+</profile></pre></div>
+<p>Set your user credentials for the stage repo in the <i>servers</i> section of your settings.xml for <a href="#archiva-repository.releases">archiva-repository.releases</a>.</p>
+<p>Execute mvn release:prepare (check that it has been properly tagged. the tag name must be.. archiva-[VERSION]).</p>
+<p>Next, execute mvn release:perform</p>
+<p>Download the uploaded files via wget:</p>
+<div class="source"><pre class="prettyprint">ex.
+wget http://archiva-repository.apache.org/archiva/repository/staged-releases/org/apache/archiva/archiva-jetty/1.3/archiva-jetty-1.3-bin.tar.gz
+Verify the signatures:
+ex.
+gpg -v archiva-jetty-1.3-bin.zip.asc</pre></div>
+<p>The documentation is deployed as part of the process to the final location for review in the vote: http://archiva.apache.org/docs/1.3/. If the vote doesn't pass, the documentation will need to be removed from the server for redeployment. Commit the sources and binaries from org/apache/archiva/archiva-jetty, and org/apache/archiva/archiva to the svn distribution tree. First in dev tree: https://dist.apache.org/repos/dist/dev/archiva/ (if the vote pass they will be copied to release tree) https://dist.apache.org/repos/dist/release/archiva</p>
+<div class="source"><pre class="prettyprint">svn co https://dist.apache.org/repos/dist/dev/archiva/ archiva-dev-release
+cd archiva-dev-release
+sh ./release-script-svn.sh VERSION STAGING_URL</pre></div>
+<p>Call for a vote in the dev list and wait for 72 hrs. for the vote results. 3 binding votes are necessary for the release to be finalized. example If the vote fails or needs to be canceled, the version number should not be re-used if the version was made available for public download. After the vote has passed, move the files from dist dev to dist release: svn mv https://dist.apache.org/repos/dist/dev/archiva/ to https://dist.apache.org/repos/dist/relase/archiva/ To sync the jars to ibiblio, execute:</p>
+<p><b>NOTE: the stage plugin doesn't work with maven3 you must use maven 2.2.1</b></p>
+<div class="source"><pre class="prettyprint"> mvn stage:copy -Dsource="https://archiva-repository.apache.org/archiva/repository/archiva-releases-stage/"
+ -Dtarget="scp://[APACHE_USERNAME]@people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository"
+ -Dversion=1.3 -DrepositoryId=apache.releases</pre></div>
+<p>mark the appropriate release version in JIRA as complete Update the archiva site (https://svn.apache.org/repos/asf/archiva/site/) for the versions and release notes URL and run mvn site-deploy. The 3 properties to change are at the bottom of pom.xml before generating the site. Once mirroring done (can be 24H): remove previous versions from https://dist.apache.org/repos/dist/release/archiva/</p>
+<p>Publish the reference docs (sh ./deploySite.sh in the archiva-modules directory) from the release tag. You may have to exclude the archiva-webapp module to do this, and will require MAVEN_OPTS=-Xmx256m. You may need to use Maven 2.2.1 instead of Maven 3.x for this.</p>
+<p>Send out an announcement of the release to:</p>
+<ul>
+<li>users@archiva.apache.org</li>
+<li>users@maven.apache.org</li>
+<li>announce@apache.org</li></ul></li></ol></div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+
+<div class="row pull-left">Apache Archiva, Archiva, Apache, the Apache feather logo, and the Apache Archiva project logos are trademarks of The Apache Software Foundation.</div>
+
+<div class="row pull-left">
+ <a href="http://archiva.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+ </div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="https://www.ohloh.net/p/6670/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
</html>
\ No newline at end of file
Modified: archiva/site-content/download.cgi
URL: http://svn.apache.org/viewvc/archiva/site-content/download.cgi?rev=1687731&r1=1687730&r2=1687731&view=diff
==============================================================================
--- archiva/site-content/download.cgi (original)
+++ archiva/site-content/download.cgi Fri Jun 26 09:39:55 2015
@@ -1,5 +1,5 @@
-#!/bin/sh
-# Just call the standard mirrors.cgi script. It will use download.html
-# as the input template.
-#
+#!/bin/sh
+# Just call the standard mirrors.cgi script. It will use download.html
+# as the input template.
+#
exec /www/www.apache.org/dyn/mirrors/mirrors.cgi $*
\ No newline at end of file