monedula-gitops docs menu
monedula-gitops apply
Apply the manifests to Kafka. Usage and flags for monedula-gitops apply.
Reference 3 of 20
Reference for monedula-gitops v1.0.0
Updated 9 October 2026
On this page
monedula-gitops apply [flags] This command can change external state. Check the flags that gate it before running it against production.
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--filename, -f | stringArray | manifest file or directory (repeatable; use - for stdin) | |
--recursive, -R | bool | recurse into directories given to -f | |
--cluster-config-file, -c | stringArray | KafkaCluster config file or directory (repeatable) | |
--cluster | string | select/filter a single cluster by name | |
--output, -o | string | human | output format: human, yaml, or json |
--dry-run | bool | render the planned operations without applying them | |
--allow-delete | bool | permit topic deletion operations (used with deletionPolicy: Delete) | |
--allow-destructive | bool | permit destructive operations (partition increase, compatibility lowering, etc.) | |
--prune | bool | delete in-scope ACLs and RBAC role bindings that are no longer desired (otherwise they are only reported) | |
--rotate-passwords | bool | re-upsert the SCRAM password of every declared, in-sync KafkaUser from its configured source (users with identity drift are updated regardless; with --dry-run the rotations are shown, not applied) |
Global flags
| Flag | Type | Default | Description |
|---|---|---|---|
--log-level | string | warn | log verbosity on stderr: error, warn, info, or debug |
Examples
monedula-gitops apply -f ./topics --cluster-config-file ./clusters/prod.yaml --dry-run
monedula-gitops apply -f ./topics --cluster-config-file ./clusters/prod.yaml
monedula-gitops apply -f ./users --cluster-config-file ./clusters/prod.yaml --rotate-passwords Exit codes
| Code | Meaning |
|---|---|
0 | Success. |
2 | Validation, configuration or connectivity error, or any failed, skipped or rejected operation. |
3 | Only Blocked operations remain and await --allow-destructive. |