Skip to content

rune get

Terminal window
rune get <resource-type> [name] [flags]
TypeAliasesNotes
servicessvcTop-level workloads.
instancesinstRunning copies of services.
namespacesnsLogical scopes.
jobsBatch workloads (roadmap).
configsConfigMaps.
secretsSecrets (values redacted).
storageclassesscCluster-scoped storage classes.
volumesvolPersistent volumes.
snapshotssnapVolume snapshots.
Terminal window
# List all services in the current namespace
rune get services
# Describe one in YAML
rune get service api -o yaml
# Across all namespaces
rune get services --all-namespaces
# Watch for live updates
rune get services --watch
# JSON for scripting
rune get instances -o json | jq '.[] | select(.status=="Running") | .id'
FlagDefaultNotes
-n, --namespacecontextTarget namespace.
-A, --all-namespacesfalseList across every namespace.
-o, --outputtabletable, json, yaml.
--watchfalseStream updates as state changes.
-l, --selectorLabel selector (e.g. app=api,tier=frontend).

rune get service <name> (singular) renders a paragraph view rather than a one-row table. It includes:

  • header line — <name> <namespace> <Status> for <age>
  • spec summary — image, scale, ready count, exposure + TLS state
  • failure block (only when Status: Failed) — short reason + the one-sentence message that explains it
  • per-instance breakdown — sorted failed-first, with the failing instance’s status message indented underneath
  • one hint command at the bottom
api prod Failed for 4m
ghcr.io/acme/api:1.4.2 · scale 2 · 0/2 ready
exposed at https://api.acme.io · TLS Issued (in 89d)
✗ ImageUnreachable
pull access denied for ghcr.io/acme/api, repository does not exist
or may require 'docker login'
Instances (2):
✗ api-7d9c-b2 node-edge-1 Failed ×6
pull access denied for ghcr.io/acme/api ...
✗ api-7d9c-a1 node-edge-2 Failed ×6
pull access denied for ghcr.io/acme/api ...
rune logs api -n prod --tail=50

-o yaml and -o json still take the structured path.

rune get services includes a REASON column between STATUS and READY. It’s - for healthy services and a short slug (ImageUnreachable, Unhealthy, Restarting, OutOfMemory, Unplaceable, ConfigMissing, LaunchFailed, Exited) for failed ones. To see the full sentence, run rune get service <name>.

  • rune get service <name> -o yaml round-trips into something you can edit and re-cast.
  • --watch is great for “what’s the rollout doing right now?” — Ctrl-C exits.
  • -o json plus jq is the scripting path. Don’t try to parse table output.