Skip to content

v0.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 11 Jul 11:53

Argonaut v0.1.0

The first public release of Argonaut — a keyboard-driven Terminal UI for Ceph.

Stop memorizing long ceph commands: browse your cluster, inspect resources, and perform common operational tasks through a fast, transparent terminal interface. Every action previews the exact ceph command it runs, and destructive changes always require confirmation.

Features

  • Dashboard — health (with full ceph health detail), capacity, client IO and recovery, refreshed live.
  • OSDs — mark in/out, reweight, destroy/purge/remove, metadata and utilisation.
  • Pools — create, edit (size/min_size/PG/autoscale/rule), delete.
  • CRUSH — interactive hierarchy tree; move buckets, view rules.
  • Cluster flags — view/toggle with descriptions, rationale and risks.
  • Services — cephadm services and daemons; restart, start, stop.
  • Placement groups — cluster-wide listing, live filter, scrub / deep-scrub / repair.
  • Consistent UX/ filters any table, : command prompt, and y/n confirmations that always preview the equivalent ceph command.

Supported platforms

  • Linux amd64 — prebuilt binary attached below.
  • Ceph Reef (18), Squid (19), Tentacle (20) — validated against real clusters (build/link CI plus per-release JSON decode fixtures).

Install

Install the Ceph client runtime libraries, then download the binary:

# Debian/Ubuntu:  sudo apt-get install -y librados2 librbd1
# RHEL/Rocky/Alma: sudo dnf install -y librados2 librbd1

VERSION=v0.1.0
BASE="https://github.com/cinpol/argonaut/releases/download/$VERSION"
curl -LO "$BASE/argonaut_${VERSION#v}_linux_amd64.tar.gz"
curl -LO "$BASE/checksums.txt"
sha256sum --ignore-missing -c checksums.txt
tar xzf "argonaut_${VERSION#v}_linux_amd64.tar.gz"
sudo install -m 0755 argonaut /usr/local/bin/argonaut
sudo argonaut

See the README for build-from-source and full requirements.

Known limitations

  • Linux amd64 only for now — arm64 and package channels (Homebrew, deb/rpm) are planned for later releases. Other platforms build from source.
  • Argonaut runs with the privileges of the operator and the Ceph keyring it is given, and performs cluster-mutating operations — treat it like the ceph CLI.

License

Apache-2.0. Argonaut dynamically links the Ceph client libraries (librados/librbd, LGPL-2.1) when built with the goceph tag. See NOTICE for third-party attribution.