svn commit: r575627 - /maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt

[oc...@apache.org]

Author: oching
Date: Fri Sep 14 04:22:33 2007
New Revision: 575627

URL: http://svn.apache.org/viewvc?rev=575627&view=rev
Log:
[MRM-385]
- Added Archiva as a Proxy section in maven-configuration.apt
- Updated some lines in the Configuring Maven-2 to use an Archiva repository section 


Modified:
    maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt

Modified: maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt
URL: http://svn.apache.org/viewvc/maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt?rev=575627&r1=575626&r2=575627&view=diff
==============================================================================
--- maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt (original)
+++ maven/archiva/trunk/archiva-site/src/site/apt/guides/maven-configuration.apt Fri Sep 14 04:22:33 2007
@@ -33,13 +33,12 @@
 
   <URL-TO-ARCHIVA> => where to find Archiva eg. http://localhost:8080/archiva
   
-  <REPOSITORY-ID> => Identifer for the proxied repository inside Archiva
+  <REPOSITORY-ID> => Identifer for the proxied repository inside Archiva eg. internal, releases
 
-  <URL-NAME> => Another identifier, this time for normal repositories [one of the these will go away]
+  ~~ <URL-NAME> => Another identifier, this time for normal repositories [one of the these will go away]
   
-
 * Configuring a Repository
-  
+
   [[1]] create a new profile to setup your repositories
 
 +-------------------------------------------------------------------------+
@@ -83,7 +82,7 @@
 +-------------------------------------------------------------------------+
   <repository>
     <id>repository-1</id>
-    <url>URL-TO-ARCHIVA/repository/URL-NAME</url>
+    <url>URL-TO-ARCHIVA/repository/REPOSITORY-ID</url>
     <releases>
       <enabled>true</enabled>
     </releases>
@@ -199,3 +198,70 @@
     -DrepositoryId=deployment.webdav
     -Durl=dav:URL-TO-ARCHIVA/repository/REPOSITORY-ID
 +------+
+
+Archiva as a Proxy
+
+* Creating a New Proxy Repository
+  
+  Archiva has pre-configured proxy connectors for the 'internal' managed repo and the 'central' and 'maven2-repository.dev.java.net' remote repositories.
+  
+  To create a new proxy repository, just do the following:
+  
+  [[1]] Add a new managed repository
+  
+  Go to Repositories --> Add (Managed Repository) 
+  
+  Create the managed repository (let's say 'releases') which would serve as the proxy repo.
+  
+  Do not forget to set the necessary permissions or user roles in Users Management if you want this repository to be secured.
+  
+  [[2]] Add a remote repository
+  
+  Go to Repositories --> Add (Remote Repository)
+   
+  Add the remote repository you want to proxy.
+  
+  [[3]] Create a proxy connector
+  
+  Go to Proxy Connectors --> Add
+  
+  Fill up the following fields:
+  
+  * Network Proxy* - if your network connection has a network proxy, then this should be configured via the Network Proxies in Archiva. Select the network proxy, if you're using one, that will be used for this proxy connector. 
+  
+  * Managed Repository* - the managed repository you want to connect to the remote repository.
+  
+  * Remote Repository* - the repository you want to proxy
+  
+  * Policies - the download policies that will be used by Archiva when proxying
+  
+  * Properties
+  
+  * Black List Patterns - the patterns that will be blacklisted during proxying
+  
+  * White List Patterns - the patterns that will be included during proxying
+  
+* Using the Proxy Repository with Maven
+  
+  Set-up your settings.xml file as shown above in sections 1 and 2 of Configuring a Repository. In this case, use the repository configuration of the managed repository you've created. 
+  
+  Then, configure the <server> settings in the settings.xml file as shown below:
+  
++-------------------------------------------------------------------------+
+  <settings>
+    ...
+    <servers>
+      <server>
+        <id>releases</id>
+        <username>{archiva-user}</username>
+        <password>{archiva-pwd}</password>
+      </server>
+      ...
+    </servers>
+    ...
+  </settings>
++-------------------------------------------------------------------------+
+  
+  Execute a Maven 2 build. Artifacts should be downloaded from the proxy repository/repositories you've set in your settings.xml
+  
+  
\ No newline at end of file