Configuring Repositories

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

Overview

This section covers the controls that are common between all repositories configuration.

Repository Key

The repository identifier needs to be valid XML ID Name, and be unique for the whole Artifactory configuration data.
So, repository keys cannot starts with a number, and it is recommended to suffix local repository with "-local".

Description

Free text describing the content and goal of the repository. This will help user configuration, UI screens and repository sharing.

Include and Exclude Patterns

It is extremely important to use include and exclude patterns for repositories. This is especially important for remote repositories in order to:

  1. Avoid Looking up remote artifacts on repositories that will never contain those artifacts, or that contain only a limited range of group ids.
  2. Not disclosing sensitive business information that can be derived from your artifact queries to whoever can intercept the queries, including the owners of the remote repository itself.

As best practices, it is easier to manage the list of remote repositories used in an organization under one virtual repository ( for example: remote-repos ).
In this case, you can globally stop querying remote repositories for companies artifacts by setting an exclude pattern on this virtual repository.

Include and exclude filtering is controlled by editing the Includes Pattern and Excludes Pattern values for a repository Admin:General:Repositories:Edit. Specify a comma separated list list of Ant-like patterns to filter-in and filter-out artifact queries. Filtering works by subtracting the excluded patterns (default is none) from the included ones (defaults to everything). for example:

Includes Pattern: org/apache/**,com/acme/**
Excludes Pattern: com/acme/exp-project/**

Will cause Artifactory to submit queries to the repository in question for org/apache/maven/parent/1/1.pom and com/acme/project-x/core/1.0/nit-1.0.jar but not for com/acme/exp-project/core/1.1/san-1.1.jar.

Labels: