maqpna status
One-screen status of an installation: release, workloads, sessions, approvals, audit ledger
Synopsis#
maqpna status [--release maqpna] [-n NS] [--kube-context C] [--gateway URL] [--token T | --oidc-token-file F] [-o table|json|yaml]Flags#
| Flag | Type | Description | Default |
|---|---|---|---|
--debug | switch | print Helm's debug log to stderr | none |
--gateway | string | gateway base URL (env MAQPNA_GATEWAY_URL; default: the context's gateway) | none |
--kube-context | string | kubeconfig context (default: the maqpna context's) | none |
-n, --namespace | string | namespace of the MAQPNA control plane (the Helm release) | maqpna-system |
--oidc-token-file | string | file holding an OIDC access token for the admin API (env MAQPNA_OIDC_TOKEN_FILE); wins over --token | none |
--release | string | Helm release name | maqpna |
--timeout | duration | timeout of Kubernetes operations (CRDs Established, --wait) | 10m0s |
--token | string | static admin token (env MAQPNA_ADMIN_TOKEN; dev/break-glass) | none |
The global flags (--context, -o, --no-color, ...) work with every command.
Examples#
maqpna status
maqpna status -n maqpna-system -o jsonWhat happens when you run it#
- Uses the Kubernetes API of your kubeconfig (
--kubeconfig,--kube-context, or the current context). - Talks to the gateway:
--gateway, elseMAQPNA_GATEWAY_URL, else the current context's gateway (maqpna context). - Authenticates to the admin API with the token stored by
maqpna login,--oidc-token-file, or a static--token(MAQPNA_ADMIN_TOKEN). - Prints a table by default;
-o jsonor-o yamlprint the data, and--jq EXPRfilters the JSON.
Exit codes#
| Code | Meaning |
|---|---|
0 | success |
1 | error (the message says what failed, with a hint when there is one) |
2 | usage error: unknown flag, missing argument or bad value; the synopsis is printed |
3 | a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command) |
Terminal demo#
This command needs a Kubernetes cluster with MAQPNA installed, so the recording shows its help. Try it against a cluster from Install.