You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@archiva.apache.org by oc...@apache.org on 2010/08/15 15:33:43 UTC
svn commit: r985674 - in
/archiva/branches/archiva-MRM-980/archiva-docs/src/site:
apt/adminguide/configuration.apt apt/adminguide/staging-repositories.apt
resources/images/conflicting-artifacts.png
resources/images/repository-merge.png site.xml
Author: oching
Date: Sun Aug 15 13:33:42 2010
New Revision: 985674
URL: http://svn.apache.org/viewvc?rev=985674&view=rev
Log:
[MRM-1407] documentation for staging & merging repositories
submitted by Patti Arachchige Eshan Sudharaka
additional changes made:
o moved to staging repos doc to admin guide instead of user guide
o added a few lines and fixed typos in the staging doc
Added:
archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/staging-repositories.apt
archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/conflicting-artifacts.png (with props)
archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/repository-merge.png (with props)
Modified:
archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/configuration.apt
archiva/branches/archiva-MRM-980/archiva-docs/src/site/site.xml
Modified: archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/configuration.apt
URL: http://svn.apache.org/viewvc/archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/configuration.apt?rev=985674&r1=985673&r2=985674&view=diff
==============================================================================
--- archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/configuration.apt (original)
+++ archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/configuration.apt Sun Aug 15 13:33:42 2010
@@ -18,5 +18,7 @@ Runtime Configuration of Apache Archiva
* {{{consumers.html} Configuring repository scanning and consumers}}
+ * {{{staging-repositories.html} Staging and merging repositories}}
+
[]
Added: archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/staging-repositories.apt
URL: http://svn.apache.org/viewvc/archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/staging-repositories.apt?rev=985674&view=auto
==============================================================================
--- archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/staging-repositories.apt (added)
+++ archiva/branches/archiva-MRM-980/archiva-docs/src/site/apt/adminguide/staging-repositories.apt Sun Aug 15 13:33:42 2010
@@ -0,0 +1,51 @@
+ ------
+ Staging Repositories
+ ------
+
+Staging Repositories
+
+ Starting with Archiva 1.4, staging repositories are supported. A staging repository is a repository you use
+ to stage a release (while it undergoes testing and voting), before the release is officially announced and published
+ to a releases repository where users can obtain it.
+
+ With the support of staging repositories comes the ability to merge repositories from the web UI. By merging, we mean
+ promoting the artifacts in the staging repository to the managed repository. In the current
+ implementation, a user can create and attach a staging repository to an existing managed repository. An attached
+ staging repository is a shadow of its managed repository, meaning they would have the same configuration.
+
+ We append <<-stage>> to the managed repository's ID to identify its staging repository. For example, repository
+ <<<test>>> would have a staging repository called <<<test-stage>>>.
+
+ If you're creating a new managed repository, just tick the <<<Create stage repository>>> check box. Otherwise, if
+ you already have an existing managed repository and you want to create a staging repository, just edit the managed
+ repository's configuration and tick the <<<Create stage repository>>> checkbox, then save the configuration. A staging
+ repository will be created in the same directory as the managed repository.
+
+ <<<Note:>>> By un-ticking the <<<Create stage repository>>> checkbox, the user can delete the attached staging
+ repository. If the managed repository is deleted, then its attached staging repository is also deleted.
+
+ The <<<snapshots>>> and <<<internal>>> repositories configured in Archiva by default, are not configured with attached
+ staging repositories.
+
+* Merging Repositories
+
+ To merge or promote the artifacts in a staging repository to the managed repository, just click the <<<Merge>>> button
+ in the repository configuration page.
+
+[../images/repository-merge.png] Merge Button
+
+ Archiva will check for conflicting artifacts between the two repositories, and list them (if it finds conflicts).
+ The user will be asked to choose between two actions:
+
+ [[1]] <<<Merge All>>> - ignore all conflicting artifacts and perform merging for all.
+
+ [[2]] <<<Merge With Skip>>> - skip all conflicting artifacts and merge only the non-conflicting ones.
+
+ []
+
+[../images/conflicting-artifacts.png] Merge Actions
+
+ In future, we plan to enhance this by allowing a user to select only specific artifacts to merge.
+
+
+
Added: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/conflicting-artifacts.png
URL: http://svn.apache.org/viewvc/archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/conflicting-artifacts.png?rev=985674&view=auto
==============================================================================
Binary file - no diff available.
Propchange: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/conflicting-artifacts.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/conflicting-artifacts.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/repository-merge.png
URL: http://svn.apache.org/viewvc/archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/repository-merge.png?rev=985674&view=auto
==============================================================================
Binary file - no diff available.
Propchange: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/repository-merge.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: archiva/branches/archiva-MRM-980/archiva-docs/src/site/resources/images/repository-merge.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: archiva/branches/archiva-MRM-980/archiva-docs/src/site/site.xml
URL: http://svn.apache.org/viewvc/archiva/branches/archiva-MRM-980/archiva-docs/src/site/site.xml?rev=985674&r1=985673&r2=985674&view=diff
==============================================================================
--- archiva/branches/archiva-MRM-980/archiva-docs/src/site/site.xml (original)
+++ archiva/branches/archiva-MRM-980/archiva-docs/src/site/site.xml Sun Aug 15 13:33:42 2010
@@ -71,6 +71,7 @@
<item name="Network Proxies" href="/adminguide/network-proxies.html" />
<item name="Legacy (Maven 1) Support" href="/adminguide/legacy.html" />
<item name="Consumers" href="/adminguide/consumers.html" />
+ <item name="Staging Repositories" href="/adminguide/staging-repositories.html"/>
</item>
<item name="Configuration Files" href="/adminguide/configuration-files.html" />
<item name="Log Files" href="/adminguide/logging.html" collapse="true">