Skip to end of metadata
Go to start of metadata
Table of Contents

Overview

Artifactory hosts three types of repository:

Local and remote repositories are true physical repositories, while a virtual repository is actually an aggregation of them used to create controlled domains for search and resolution of artifacts.

To configure repositories, in the Admin tab, go to Configuration | Repositories.

Repositories can be created, deleted, edited, ordered and aggregated.

Page Contents

 

 

Local Repositories

Local repositories are physical, locally-managed repositories into which you can deploy artifacts.

Artifacts in a local repository can be accessed directly using the following URL:
http://<host>:<port>/artifactory/<local-repository-name>/<artifact-path>

Artifactory is deployed with a number of pre-configured local repositories which can be used for internal and external releases, snapshots and plugins.

For full details on configuring local repositories, please refer to Local Repositories.


Remote Repositories

A remote repository serves as a caching proxy for a repository managed at a remote URL (which may itself be another Artifactory remote repository).  

Artifacts are stored and updated in remote repositories according to various configuration parameters that control the caching and proxying behavior. You can remove artifacts from a remote repository cache but you cannot actually deploy a new artifact into a remote repository.

Artifacts in a remote repository can be accessed directly using the following URL:

http://<host>:<port>/artifactory/<remote-repository-name>/<artifact-path>

This URL will fetch a remote artifact to the cache if it has not yet been stored.

In some cases it is useful to directly access artifacts that are already stored in the cache (for example to avoid remote update checks).

Configuring Repositories

To directly access artifacts that are already stored in the cache you can use the following URL:

http://<host>:<port>/artifactory/<remote-repository-name>-cache/<artifact-path> 

Artifactory is deployed with a number of pre-configured, remote repositories which are in common use. Of course you can change these according to the needs of your organization.

Remote repository configuration can also be imported from another instance of Artifactory. The JFrog Public Repository contains an up-to-date list of standard remote repositories that are freely available on the net. For more details please refer to Shared Repository Configurations.

Proxy vs. Mirror

A remote repository acts as a proxy not as a mirror. Artifacts are not pre-fetched to a remote repository cache. They are only fetched and stored on demand when requested by a client.
Therefore, a remote repository should not contain any artifacts in its cache immediately after creation. Artifacts will only be fetched to the cache once clients start working with the remote repository and issuing requests.

For full details on configuring remote repositories please refer to Remote Repositories.


Virtual Repositories

A virtual repository (or "repository group") aggregates several repositories under a common URL. The repository is virtual in that you can resolve and retrieve artifacts from it but you cannot deploy artifacts to it.

The Default Virtual Repository

By default, Artifactory uses a global virtual repository available at:

http://<host>:<port>/artifactory/repo

This repository contains all local and remote repositories.

Virtual Resolution Order

When an artifact is requested from a virtual repository, the order in which repositories are searched or resolved is local repositories first, then remote repository caches, and finally remote repositories themselves.

Within each of these, the order by which repositories are queried is determined by the order in which they are listed in the configuration as described in General Resolution Order below.

For a virtual repository, you can see the effective search and resolution order in the Resolved Repositories list view in the Edit Virtual Repositories dialog. This is particularly helpful when nesting virtual repositories. For more details on configuring a virtual repository please refer to Virtual Repositories.


General Resolution Order

You can set the order in which repositories of each type (local, remote and virtual) are searched and resolved by simply ordering them accordingly within the corresponding section of the Configure Repositories page. To change the order, you can simply drag and drop a repository, or use the "up/down" arrow buttons on the right. You must click "Save" to save your changes, or "Reset" to cancel them.

The order in which repositories are resolved is also affected by additional factors such as security privileges, include/exclude patterns and policies for handling snapshots and releases.

 

 

  • No labels