Skip to main content
emisar

JFrog Artifactory

v0.1.4

JFrog Artifactory ops reads — health, version, license, storage usage, repository listings, artifact info and download stats, background tasks. Read-only. Auth via an access token or Basic credentials on the runner host.

8 allowed by default
Pack ID
artifactory
Vendor
emisar
OS
linux
Actions
8
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
curl

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host 
sudo emisar pack install artifactory --hash sha256:6320f0eb42b768f5e88d5443498c9127f8043210d5f3cc7522e6cb582d42c13a

Setup

Every action calls the Artifactory REST API under $ARTIFACTORY_URL via curl. Set $ARTIFACTORY_TOKEN for bearer authentication with an access token, or $ARTIFACTORY_USER and $ARTIFACTORY_PASSWORD for Basic authentication.

Environment

Set these on the runner host, then add each name to execution.inherit_env so the value reaches the action.

  • ARTIFACTORY_URL default http://127.0.0.1:8082

    JFrog platform base URL (scheme + host + port, no trailing path) — actions append /artifactory/api/... themselves. Defaults to the local platform router.

  • ARTIFACTORY_TOKEN

    Access token sent as the Bearer credential.

  • ARTIFACTORY_USER

    User for Basic authentication. Takes precedence over ARTIFACTORY_TOKEN .

  • ARTIFACTORY_PASSWORD

    Password paired with ARTIFACTORY_USER .

Notes

  • Any Artifactory env var you set must also be allowlisted in the runner's execution.inherit_env — the action env is scrubbed to PATH/LANG/LC_ALL/TERM by default, so an env present on the host but not allowlisted is silently dropped (the action falls back to its local default or fails auth).
  • System, storage, and task reads need an admin-scoped identity; repository and artifact reads work with read permission on the target repository.
  • Every action here works on every edition, OSS included. Repository administration and user listing are Artifactory Pro APIs, so this pack does not ship them.

Verify it works

Runs artifactory.ping, a low-risk read that confirms the pack can reach its target. Run it on the host once the pack is installed; pack install runs it for you.

on the runner host 
sudo emisar pack verify artifactory

Install and configure a pack walks through the whole sequence on a host.

Actions 8 total

View on GitHub
  • artifactory.file_info script low Low — read-only or trivially reversible

    GET /artifactory/api/storage/<repo>/<path>

    Show one artifact or folder — size, checksums, created/modified times, and for folders the direct children.

    View source on GitHub
  • artifactory.file_stats script low Low — read-only or trivially reversible

    GET /artifactory/api/storage/<repo>/<path>?stats

    Show download stats for one artifact — download count, last downloaded time, and who downloaded it last.

    View source on GitHub
  • artifactory.license script low Low — read-only or trivially reversible

    GET /artifactory/api/system/license

    Show license type, expiry, and licensed-to (never the license key itself).

    View source on GitHub
  • artifactory.ping script low Low — read-only or trivially reversible

    GET /artifactory/api/system/ping

    Check Artifactory liveness (returns OK when healthy).

    View source on GitHub
  • artifactory.repositories script low Low — read-only or trivially reversible

    GET /artifactory/api/repositories

    List repositories (key, type, package type, URL), optionally filtered by repository class or package type.

    View source on GitHub
  • artifactory.storage_summary script low Low — read-only or trivially reversible

    GET /artifactory/api/storageinfo

    Show filestore usage totals and the per-repository storage breakdown (size, file and folder counts).

    View source on GitHub
  • artifactory.tasks script low Low — read-only or trivially reversible

    GET /artifactory/api/tasks

    List background tasks (indexing, garbage collection, replication) with their type, state, and schedule.

    View source on GitHub
  • artifactory.version script low Low — read-only or trivially reversible

    GET /artifactory/api/system/version

    Show Artifactory version, revision, and enabled addons.

    View source on GitHub
← Back to registry
Pack reference  Publish your own