| ------ |
| Local Repository |
| ------ |
| ------ |
| 2010-02-18 |
| ------ |
| |
| ~~ 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. |
| |
| Local Repository |
| |
| Local repositories can be configured for a specific project group's use. |
| This is where the artifacts used for building the projects can be found |
| instead of the default (<<<$USER_HOME/.m2/repository>>>). |
| |
| Click the <<Local Repositories>> link under the <<Administration>> section |
| |
| [../images/localrepositories.png] Local Repositories |
| |
| You will see all the local repositories that have been created. |
| |
| To display: |
| |
| [../images/localrepositories-view.png] |
| |
| In this screen you can add/edit/delete/purge a local repository. |
| |
| You can purge a repository if it has a default {{{./purgeConfiguration.html} Purge Configuration}}, otherwise the purge icon is disabled. |
| |
| [../images/disabled_purgenow.gif] disabled purge icon |
| |
| |
| * Adding / Editing a Local Repository |
| |
| All fields are mandatory. |
| |
| * Name: must be a unique repository name. |
| |
| * Location: must be the absolute path of a unique repository location. |
| |
| * Layout: "default" or "legacy". Default layout is for maven2, while legacy layout is for maven1. |
| |
| [../images/localrepository-add.png] |
| |
| Adding a local repository will automatically create a default {{{./purgeConfiguration.html} Purge Configuration}} for that repository. |
| |
| If you're using distributed builds, you must configure a <<<localRepository>>> with the same <<<name>>> in the build agent's configuration file where the |
| <<<location>>> is the local path to the local repository in the build agent machine. See {{{./distributed-builds.html}Distributed Builds}} for more details. |
| |
| * Default |
| |
| ~~ TODO: Needs to be updated if CONTINUUM-1966 is implemented to allowe editing the local repo. |
| |
| The default local repository location comes from the settings of the user running Continuum. The location cannot be |
| edited within Continuum, but can be changed by specifying it in <<<~/.m2/settings.xml>>>. |
| |
| On Windows 7, you can pass the argument <<<-Duser.home=C:\Users\\\<Username\>\\>>> to the JVM explicitly. Since running Continuum as an Administrator |
| will give you a different <<<user.home>>> value. |