Skip to content

JFrog Artifactory Disk Usage command line utility - View the size of each directory in artifactory as text

License

Notifications You must be signed in to change notification settings

devopshq/artifactory-du

Repository files navigation

Artifactory Disk Usage cli (artifactory-du)

docs dohq build status dohq on PyPI artifactory-du license

artifactory-du - estimate file space usage

Summarize disk usage in JFrog Artifactory of the set of FILEs, recursively for directories.

Table of Contents

Installation

The easiest way is using docker!

docker pull devopshq/artifactory-du
docker run devopshq/artifactory-du --version
# Install from PyPi
# python -mpip install artifactory-du

# From git
python -mpip install git+https://github.com/devopshq/artifactory-du.git

# and try to get help
artifactory-du --help

Usage

artifactory-du is used in the same manner as original du from *nix, although launch options are different. See artifactory-du --help for details.

# Recursive summary for root folder in repo.snapshot
artifactory-du --username username --password password --artifactory-url https://repo.example.ru/artifactory --repository repo.snapshot -h -s *

# Set alias for linux
alias adu=artifactory-du --username username --password password --artifactory-url https://repo.example.ru/artifactory --repository repo.snapshot -h
# usage
adu --max-depth=2 /*

# Set alias for Windows
set "adu=artifactory-du --username username --password password --artifactory-url https://repo.example.ru/artifactory --repository repo.snapshot -h"
# usage
%adu% --max-depth=2 /*

Below we skip artifactory-specific options: username, password, artifactory-url, repository, because we use ALIAS (for linux-bash or windows-cmd

# Summary for subfolder in folder
adu --max-depth=2 folder/*

# show 2 folder level inside repository
adu --max-depth=2 *

# Show only directory with GB size
adu --max-depth=0 * | grep G

# Show artifacts that have never been downloaded
adu --max-depth=0 * --without-downloads | grep G

# Show artifacts older than 30 days
adu --max-depth=0 * --older-than 30 | grep G

Artifactory options

Connection

  • --artifactory-url http://arti.example.com/artifactory -URL to artifactory, e.g: https://arti.example.com/artifactory"
  • --username USERNAME - user which has READ access to repository
  • --password PASSWORD, - user's password which has READ access to repository
  • --repository REPOSITORY - Specify repository
  • --verbose - increase output verbosity

Specific

  • --without-downloads - Find items that have never been downloaded (stat.downloads == 0)
  • --older-than DAY_COUNT - only counts size for files older than DAY_COUNT

DU options

  • --max-depth N - print the total size for a directory (or file, with --all) only if it is N or fewer levels below the command line argument; --max-depth=0 is the same as --summarize
  • --human-readable, -h - print sizes in human readable format (e.g., 1K 234M 2G)
  • --all - write counts for all files, not just directories
  • --summarize - display only a total for each argument

Known issues

  1. Does not support filename in <file>: artifactory-du -h -s */*.deb will fail
  2. Does not print folder if summarize folder: artifactory-du -h -s foldername will out: 123G / , expected as original du: 123G foldername

CONTRIBUTING

How to contribute to the project:

  • Create your own github-fork
  • Change files
  • Create a pull request to the develop-branch

How to create a release:

Advertising


Inspired by https://github.com/reversefold/artifactory-disk-usage

Releases

No releases published

Packages

No packages published

Languages