Skip to content

Astrona

astrona

Astrona is the Astrona lab community CLI

Synopsis

Astrona is the single CLI for the Astrona lab community: spin up local Kubernetes labs, grade them, and (as more groups land) publish and authenticate against the Astrona platform.

Astrona is free and built on donations and community support — thank you to everyone who contributes, sponsors, and helps keep it going.

Options

  -c, --config string    Path or URL to the lab config directory (with --git: a subdirectory within the cloned repo) (default ".")
  -f, --file string      Configuration file name override (default "config.yaml")
      --git string       Git repository URL to clone/pull (https://, git@host:, or ssh://) — --config then selects a subdirectory within it
      --git-ref string   Git branch, tag, or commit to check out (used with --git; default: the repo's default branch)
  -h, --help             help for astrona

SEE ALSO

  • astrona check - Check that astrona's dependencies are installed
  • astrona destroy - Tear down a lab environment (both the normal run and any leftover 'astrona test' run)
  • astrona images - Inspect astrona's local qemu base image cache
  • astrona list - List astrona labs (qemu VMs and kind clusters) known on this machine
  • astrona run - Spin up a lab environment
  • astrona ssh - SSH into a running qemu lab VM (name as shown by 'astrona list')
  • astrona submit - Submit the lab to the Proctor for grading
  • astrona test - Run the full lab lifecycle for CI: bootstrap, testing, submit, teardown
  • astrona upgrade - Upgrade astrona-cli to the latest version
Auto generated by spf13/cobra on 22-Aug-2026