Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<p>Repository is one of the fondamental maven concept. It's simple to understand but fair usage request a bit of practise.</p>

<p>You should have a clearer idea of repository management best practises through the following examples and <a class="confluence-link" href="#Counterexamples" data-anchor="Counterexamples" data-linked-resource-default-alias="Counterexamples" data-base-url="http://docs.codehaus.org">counterexamples</a>.</p>

<h1>Initial configuration</h1>

<p>This configuration come with maven without doing anything.
<br class="atl-forced-newline" />  <img class="confluence-embedded-image" src="/download/attachments/231079967/00-initial.png?version=1&amp;modificationDate=1369177979503" data-image-src="/download/attachments/231079967/00-initial.png?version=1&amp;modificationDate=1369177979503" data-linked-resource-id="231374960" data-linked-resource-type="attachment" data-linked-resource-default-alias="00-initial.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231079967" title="null > 00-initial.png"></p>

<p>The <a class="confluence-link" href="#Simpleproject" data-anchor="Simpleproject" data-linked-resource-default-alias="Simpleproject" data-base-url="http://docs.codehaus.org">&quot;simple project&quot; pom</a>. </p>

<h1>Extended usage</h1>

<h2>Without repository manager </h2>

<p> <img class="confluence-embedded-image" src="/download/attachments/231079967/01-extended.png?version=1&amp;modificationDate=1369177979500" data-image-src="/download/attachments/231079967/01-extended.png?version=1&amp;modificationDate=1369177979500" data-linked-resource-id="231374959" data-linked-resource-type="attachment" data-linked-resource-default-alias="01-extended.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231079967" title="null > 01-extended.png"></p>

<p>Take a look on <a class="confluence-link" href="#Extendedproject" data-anchor="Extendedproject" data-linked-resource-default-alias="Extendedproject" data-base-url="http://docs.codehaus.org">the &quot;extended project&quot; pom</a>.</p>

<h2>With repository manager</h2>

<p><img class="confluence-embedded-image" src="/download/attachments/231079967/05-extended-rm.png?version=1&amp;modificationDate=1369177979499" data-image-src="/download/attachments/231079967/05-extended-rm.png?version=1&amp;modificationDate=1369177979499" data-linked-resource-id="231374958" data-linked-resource-type="attachment" data-linked-resource-default-alias="05-extended-rm.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231079967" title="null > 05-extended-rm.png"><br />
The &quot;extended project&quot; pom don't change, we just add mirrors section in the settings.xml (M2_HOME/conf/settings.xml or ~/.m2/settings.xml).<br />
Take a look on <a class="confluence-link" href="#Settings.xmlincludingrepositorymirrorsdefinitions" data-anchor="Settings.xmlincludingrepositorymirrorsdefinitions" data-linked-resource-default-alias="Settings.xmlincludingrepositorymirrorsdefinitions" data-base-url="http://docs.codehaus.org">the Mirrors definitions in settings.xml</a>. <br />
 </p>

<h1>Complex usage</h1>

<h1>Counterexamples</h1>

<h2>Single repo mirroring multiple repositories</h2>

<p><img class="emoticon emoticon-warning" data-emoticon-name="warning" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/warning.png" alt="(warning)" title="(warning)" /> THIS IS A COUNTEREXAMPLE</p>

<h2>Mirror repository defined in place of original repository.</h2>

<h1>Annexes</h1>

<h3>Simple project</h3>

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  &lt;modelVersion>4.0.0&lt;/modelVersion>
  &lt;groupId>org.apache.maven.example.repository-management&lt;/groupId>
  &lt;artifactId>initial&lt;/artifactId>
  &lt;packaging>jar&lt;/packaging>
  &lt;version>1.0-SNAPSHOT&lt;/version>
  &lt;name>Simple repository example&lt;/name>
&lt;/project>
</pre></td></tr></table>

<h3>Extended project</h3>

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  &lt;modelVersion>4.0.0&lt;/modelVersion>
  &lt;groupId>org.apache.maven.example.repository-management&lt;/groupId>
  &lt;artifactId>extended&lt;/artifactId>
  &lt;packaging>jar&lt;/packaging>
  &lt;version>1.0-SNAPSHOT&lt;/version>
  &lt;name>Extended usage of repository example&lt;/name>

&lt;build>
    &lt;plugins>
      &lt;plugin>
        &lt;groupId>org.codehaus.cargo&lt;/groupId>
        &lt;artifactId>cargo-maven2-plugin&lt;/artifactId>
        &lt;version>0.3-SNAPSHOT&lt;/version>
      &lt;/plugin>
    &lt;/plugins>
  &lt;/build>

&lt;dependencies>
    &lt;dependency>
      &lt;groupId>org.mortbay.jetty&lt;/groupId>
      &lt;artifactId>jetty&lt;/artifactId>
      &lt;version>6.1.6&lt;/version>
    &lt;/dependency>
  &lt;/dependencies>

&lt;repositories>
    &lt;repository>
      &lt;id>codehaus&lt;/id>
      &lt;name>Codehaus Release Repo&lt;/name>
      &lt;url>http://dist.codehaus.org/&lt;/url>
    &lt;/repository>
    &lt;repository>
      &lt;id>codehaus-snapshot&lt;/id>
      &lt;name>Codehaus Snapshot Repo&lt;/name>
      &lt;url>http://snapshots.repository.codehaus.org&lt;/url>
      &lt;releases>
        &lt;enabled>false&lt;/enabled>
      &lt;/releases>
    &lt;/repository>
  &lt;/repositories>

&lt;pluginRepositories>
    &lt;pluginRepository>
      &lt;id>codehaus&lt;/id>
      &lt;name>Codehaus Release Repo&lt;/name>
      &lt;url>http://repository.codehaus.org&lt;/url>
    &lt;/pluginRepository>
    &lt;pluginRepository>
      &lt;id>codehaus-snapshot&lt;/id>
      &lt;name>Codehaus Snapshot Repo&lt;/name>
      &lt;url>http://snapshots.repository.codehaus.org&lt;/url>
    &lt;/pluginRepository>
  &lt;/pluginRepositories>

&lt;/project>
</pre></td></tr></table>
<p> <img class="emoticon emoticon-information" data-emoticon-name="information" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/information.png" alt="(info)" title="(info)" /> Note that some repository declarations are useless:</p>
<ul>
	<li>Jetty is now available on central repository so you can remove</li>
</ul>

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;pluginRepository>
      &lt;id>codehaus&lt;/id>
      &lt;name>Codehaus Release Repo&lt;/name>
      &lt;url>http://repository.codehaus.org&lt;/url>
    &lt;/pluginRepository>
</pre></td></tr></table>
<ul>
	<li> The project don't have any dependencies on snapshot version of codehaus artefacts so you can remove</li>
</ul>

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;repository>
      &lt;id>codehaus-snapshot&lt;/id>
      &lt;name>Codehaus Snapshot Repo&lt;/name>
      &lt;url>http://snapshots.repository.codehaus.org&lt;/url>
      &lt;releases>
        &lt;enabled>false&lt;/enabled>
      &lt;/releases>
    &lt;/repository>
</pre></td></tr></table>

<h3> Advanced project</h3>

<h2>Settings.xml including repository mirrors definitions</h2>

<p><br class="atl-forced-newline" /></p>
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;settings>
  &lt;mirrors>
    &lt;mirror>
      &lt;id>codehaus-mirror&lt;/id>
      &lt;mirrorOf>codehaus&lt;/mirrorOf>
      &lt;name>Codehaus Release Repo Mirror&lt;/name>
      &lt;url>http://[repository-manager-url]/codehaus-mirror/&lt;/url>
    &lt;/mirror>
    &lt;mirror>
      &lt;id>codehaus-snapshot&lt;/id>
      &lt;mirrorOf>codehaus&lt;/mirrorOf>
      &lt;name>Codehaus Snapshot Repo Mirror&lt;/name>
      &lt;url>http://[repository-manager-url]/codehaus-snapshot/&lt;/url>
    &lt;/mirror>
  &lt;/mirrors>
&lt;/settings>
</pre></td></tr></table>
<p><br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></p>