monedula-gitops import cluster

Read live cluster state and generate KafkaTopic/KafkaAccessPolicy manifests. Usage and flags for monedula-gitops import cluster.

Reference 10 of 20

Reference for monedula-gitops v1.0.0

Updated 9 October 2026

usage

monedula-gitops import cluster [flags]

Read-only: this command does not change the cluster.

Flags

Flag	Type	Default	Description
`--cluster-config-file, -c`	stringArray		KafkaCluster config file or directory (repeatable)
`--cluster`	string		select a single cluster by name (required when more than one is loaded)
`--output-dir`	string		write manifests to this directory tree instead of stdout
`--overwrite`	string	`never`	overwrite mode when writing to --output-dir: never, changed, or always
`--output, -o`	string	`human`	summary output format: human, yaml, or json
`--skip-schemas`	bool		skip schema reconstruction entirely (no Schema Registry connection); use when schemas are application-managed
`--skip-users`	bool		skip SCRAM credential reconstruction entirely (no ListScramCredentials call); use when users are application-managed
`--skip-quotas`	bool		skip quota reconstruction entirely (no DescribeClientQuotas call); use when quotas are unsupported (e.g. Confluent Cloud) or externally managed
`--include-connecting-user`	bool		include the connecting principal's own SCRAM credential (skipped by default to avoid self-lockout risk)
`--include-internal`	bool		import Kafka/Confluent housekeeping topics too (__, _schemas, _confluent); skipped by default
`--namespace-strategy`	string	`single`	namespace strategy: single, prefix, regex, or mapping-file
`--namespace`	string	`default`	namespace value for the single strategy
`--prefix-separator`	string	`.`	separator for the prefix strategy
`--namespace-regex`	string		regex with one capture group for the regex strategy
`--namespace-mapping-file`	string		path to a YAML/JSON topic->namespace map for the mapping-file strategy

Global flags

Flag	Type	Default	Description
`--log-level`	string	`warn`	log verbosity on stderr: error, warn, info, or debug

Examples

examples

monedula-gitops import cluster --cluster-config-file ./clusters/prod.yaml > topics.yaml
monedula-gitops import cluster --cluster-config-file ./clusters/prod.yaml --output-dir ./imported

Exit codes

Code	Meaning
`0`	Success.
`2`	Validation, configuration or connectivity error.