Cache Settings for Remote Repositories

JFrog Artifactory Documentation

ft:sourceType
Paligo

Artifactory stores artifacts retrieved from a remote repository in a local cache. The Cache Settings specify how to manage cached artifacts.

Caching Maven artifacts

Caching for Maven artifacts is only applicable to snapshots since it is assumed that releases never change.

remote-repo_cache-settings.png

Field

Description

Unused Artifacts Cleanup Period

Many cached artifacts in Artifactory remote repository storage are actually unused by any current projects in the organization. This parameter specifies how long an unused artifact will be stored before it is removed. Once reaching this period Artifacts will be removed in the next invocation of cleanup. For more details please refer to Cleanup Unused Cached Artifacts in Regular Maintenance OperationsRegular Maintenance Operations

Leaving the field empty (default) means that the artifact is stored indefinitely.

Metadata Retrieval Cache Period

Defines how long before Artifactory checks for a newer version of a requested artifact in a remote repository.

A value of 0 means that Artifactory will always check for a newer version.

On which file types does this parameter work?

This setting refers to artifacts that expire after a period of time (e.g. metadata files such as maven-metadata.xml, npm package.json or Docker manifest.json etc.).

Note that most artifacts that are downloadeddo not change (e.g. release versions), therefore this setting has no effect on them.

Metadata Retrieval Cache Timeout

Allows you to control the Metadata timeout performance. If the timeout is reached, the previous metadata is returned to the client, as a lock was not applied due to new metadata, leaving the previous request hanging. The default value is 60 seconds.

Assumed Offline Period

In case of a connection error, this parameter specifies how long (in seconds) Artifactory should wait before attempting an online check to reset the offline status.

A value of 0 means that the repository is never assumed offline and Artifactory will always attempt to make the connection when demanded. The default value is 300 seconds.

Missed Retrieval Cache Period

If a remote repository is missing a requested artifact, Artifactory will return a "404 Not found" error. This response is cached for the period of time specified by this parameter. During that time, Artifactory will not issue new requests for the same artifact.

A value of 0 means that the response is not cached and Artifactory will always issue a new request when demanded. The default value is 1800 seconds.