`maqpna preflight`

Check a cluster before installing MAQPNA (read-only; exit 3 when a check fails)

Operateplugin: maqpna-install-o json | yaml

Synopsis#

maqpna preflight [--profile dev|prod|sovereign-eu] [-f values.yaml] [--set K=V] [--chart oci://...|DIR] [--version V]
                 [-n maqpna-system] [--kube-context C] [--strict] [-o table|json|yaml]

Description#

Takes the same chart and value flags as 'maqpna install' and evaluates the values that install would use. Nothing is created.

Flags#

Flag	Type	Description	Default
`--chart`	string	chart: oci:// reference, directory, .tgz, or a chart name with `--repo`	`oci://<release-registry>/charts/maqpna`
`--debug`	switch	print Helm's debug log to stderr	none
`-f`, `--values`	string	values file (repeatable)	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`
`--password`	string	registry/repository password (env MAQPNA_CHART_PASSWORD)	none
`--plain-http`	switch	pull the chart over plain HTTP (in-cluster test registries)	none
`--profile`	string	values profile shipped with the chart: dev\|prod\|sovereign-eu (lowest priority)	none
`--release`	string	Helm release name	`maqpna`
`--repo`	string	chart repository URL (with `--chart` NAME)	none
`--set`	string	set a value, KEY=VAL (repeatable)	none
`--set-file`	string	set a value from a file, KEY=PATH (repeatable)	none
`--set-json`	string	set a JSON value, KEY=JSON (repeatable)	none
`--set-string`	string	set a string value, KEY=VAL (repeatable)	none
`--strict`	switch	exit 3 on warnings too	none
`--timeout`	duration	timeout of Kubernetes operations (CRDs Established, `--wait`)	`10m0s`
`--username`	string	registry/repository username (env MAQPNA_CHART_USERNAME)	none
`--version`	string	chart version (default: this CLI's version)	none

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

Examples#

$ maqpna preflight --profile dev
$ maqpna preflight --profile prod -f values.yaml --strict

What happens when you run it#

Runs the lifecycle plugin maqpna-install (next to maqpna or on PATH), which drives the Helm v3 SDK against the cluster of your kubeconfig (--kubeconfig, --kube-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 preflight --help.cast

This command needs a Kubernetes cluster with MAQPNA installed, so the recording shows its help. Try it against a cluster from Install.

maqpna preflight