`maqpna version`

Print the CLI version, or every component's version with the skew check

Configure-o json | yaml

Synopsis#

maqpna version                     (client version only, plain text)
maqpna version --client [-o json|yaml]
maqpna version [--check] [--gateway URL] [--identity URL] [--attest URL] [--operator-url URL]
               [--operator-namespace NS] [--no-kube] [-o table|json|yaml]     (exit 3 on unsupported skew)

Description#

Supported skew: gateway, identity, attest and operator on the same minor version; the CLI within one minor version of them; every maqpna.com CRD known to this CLI installed and serving v1alpha1. Development builds ("dev") are reported but not compared.

Flags#

Flag	Type	Description	Default
`--attest`	string	attestation service base URL (default: the context's)	none
`--check`	switch	enforce the version skew policy (exit 3 on unsupported skew)	none
`--client`	switch	client version only (no network)	none
`--gateway`	string	gateway base URL (env MAQPNA_GATEWAY_URL; default: the context's)	none
`--identity`	string	identity broker base URL (default: the context's)	none
`--no-kube`	switch	do not query the Kubernetes API (operator, CRDs, image tags)	none
`--operator-namespace`	string	namespace of the MAQPNA control plane	`maqpna-system`
`--operator-url`	string	operator metrics server base URL (GET /version); default: the Kubernetes API	none
`--timeout`	duration	overall timeout for the server queries	`10s`

The global flags (--context, -o, --no-color, ...) work with every command.

Examples#

$ maqpna version
$ maqpna version --check
$ maqpna version --client -o json

What happens when you run it#

Talks to the gateway: --gateway, else MAQPNA_GATEWAY_URL, else the current context's gateway (maqpna context).
Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.
Exits 3 when the check fails or a result does not match (see exit codes below), so scripts and CI can act on it.

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)

Terminal demo#

maqpna version.cast