Link Search Menu Expand Document
LZone

jfrog Artifactory Cheat Sheet

Configure Client

jfrog config show
jfrog config add <env name>
jfrog config use <env name>

Test configuration with

jfrog rt ping                            # Should return "OK"

Builds

jfrog rt podman-push <tag> --build-name=<name> --build-number=<number>
jfrog rt bp <name> <number>              # Create build
jfrog rt bs <name> <number>              # Scan build with XRay

API Queries

jfrog API docs

jfrog rt cl <API path>                    # Run curl commands using stored credentials

jfrog rt cl /api/build                    # List builds
jfrog rt cl /api/build/<name>             # Get build runs
jfrog rt cl /api/build/<name>/<id>        # Get build run info

jfrog rt cl /api/storage/<path>           # File listing
jfrog rt cl /api/compliance/<path>        # Compliance details

API Search Queries

Quick Search

# Any artifact in a folder
jfrog rt cl /api/search/artifact?name=<file name>&repos=<repo name>

# Maven artifact
jfrog rt cl /api/search/gavc?g=<group>&a=<artifact>&v=<version>&c=<classifier>&repos=<repo>

# Pattern search
jfrog rt cl /api/search/pattern?pattern=<repo>:<ant pattern>
jfrog rt cl /api/search/pattern?pattern=libs-release-local:killer/*/ninja/*/*.jar

# Reverse dependency lookup
jfrog rt cl /api/search/dependency?sha1=<checksum>

# Get list of repos
jfrog rt cl /api/repositories

AQL Searches

AQL searches can be performed via API as POST request against /api/search/aql. For example with curl:

curl "<server>/api/search/aql" \
    -H "Content-Type: text/plain" \
    -d 'items.find({ "repo":{"$eq":"libs-release-local"} })'

jfrog AQL Examples

Alternatively to quick search you can perform complex queries using AQL

AQL for searching artifacts

// Find packages by name matching
items.find({"name":{"$match":"mypackage-*"}})

// Find packages by type
items.find({"type":{"$eq":"conan"}})

// Find by property
items.find({"@property": {"$eq" : "value"}})
items.find({"@artifactory.licenses":"*"})

// Find everything by time
items.find({"created" : {"$gte":"2020-01-01"}})
items.find({"modified": {"$gte":"2020-01-01"}})

AQL for searching repos

// Find repo by name
items.find({"repo":{"$eq":"libs-release-local"}})

AQL for searching builds

// Return all artifacts of the "artifactory" build.
items.find({"@build.name":{"$eq":"artifactory"}})

// Return all builds that have a dependency with a license that is not Apache.
builds.find({"[email protected]":{"$nmatch":"Apache-*"}})

AQL for archive searches

// Return all archives containing a file called "org/artifactory/Main.class".
items.find({"archive.entry.name":{"$eq":"Main.class"} , "archive.entry.path":{"$eq":"org/artifactory"}})

AQL Filtering / Pagination

// Pagination
items.find(...).limit(100)
items.find(...).offset(100).limit(50)

Advanced

// Negativ matching
items.find({"name":{"$nmatch":"<pattern>"}})

// List all properties
items.find(...).include("repo", "name", "path", "properties.*")