GitOps for Apache Kafka: topics, access, quotas, schemas, SCRAM users and Confluent RBAC, from a CLI or a Kubernetes operator.
Documentation: monedula.dev/flock/docs/gitops
- Install monedula-gitops: the CLI and the operator's Helm chart
- Get started with the CLI or with the operator
- CLI overview: every command, flag and exit code
- Resource reference: the fields of each resource kind, starting with
KafkaTopic - Supported platforms and versions: Apache Kafka, Confluent Platform and Confluent Cloud
- How monedula-gitops compares with Jikkou, JulieOps, Strimzi, Confluent for Kubernetes, kafka-gitops and the Terraform provider
brew install monedula-dev/tap/monedula-gitopsThe install page covers go install, Docker, the prebuilt binaries and the operator.
Preview, apply and check a directory of manifests against the cluster that cluster.yaml describes:
monedula-gitops diff -f manifests/ --cluster-config-file cluster.yaml
monedula-gitops apply -f manifests/ --cluster-config-file cluster.yaml
monedula-gitops verify -f manifests/ --cluster-config-file cluster.yaml # exits 1 on driftquickstart/cli has a local Kafka and Schema Registry and the manifests to run these commands against.
quickstart/holds two local playgrounds:cli/with Docker Compose andk8s/with the operator on k3d. Get started with the CLI and Get started with the operator walk through them step by step.scenarios/holds 25 end-to-end scenarios, each with a README and a test that CI runs. Each how-to guide in the docs links the scenario that runs it; for example, Grant producers and consumers access linksscenarios/05-topic-with-access.
CI runs the adapter integration tests against every cell below on each pull request, and the end-to-end scenario suite against the e2e cells nightly, on every push to main and on demand. Confluent Cloud is validated with the opt-in maintainer harness (make e2e-cloud), not in CI; Supported platforms and versions lists what it supports.
| Cell | Broker image | Schema Registry image | Tiers | Capabilities |
|---|---|---|---|---|
ak-3.9 |
apache/kafka:3.9.2 |
— |
integration | topics, acls, quotas, scram |
ak-4.0 |
apache/kafka:4.0.2 |
— |
integration | topics, acls, quotas, scram |
ak-4.3 |
apache/kafka:4.3.1 |
— |
integration | topics, acls, quotas, scram |
ak-4.4 |
apache/kafka:4.4.0 |
confluentinc/cp-schema-registry:8.3.1 |
integration, e2e | topics, acls, quotas, scram, schemaregistry |
cp-7.6 |
confluentinc/cp-kafka:7.6.13 |
confluentinc/cp-schema-registry:7.6.13 |
integration | topics, acls, quotas, scram, schemaregistry |
cp-7.9 |
confluentinc/cp-kafka:7.9.9 |
confluentinc/cp-schema-registry:7.9.9 |
integration, e2e | topics, acls, quotas, scram, schemaregistry |
cp-8.0 |
confluentinc/cp-kafka:8.0.7 |
confluentinc/cp-schema-registry:8.0.7 |
integration | topics, acls, quotas, scram, schemaregistry |
cp-8.3 |
confluentinc/cp-kafka:8.3.1 |
confluentinc/cp-schema-registry:8.3.1 |
integration, e2e | topics, acls, quotas, scram, schemaregistry |
cp-7.6-mds |
confluentinc/cp-server:7.6.13 |
— |
e2e | topics, acls, quotas, scram, mds |
cp-8.3-link |
confluentinc/cp-server:8.3.1 |
— |
e2e | topics, acls, cluster-linking |
make matrix-docs generates this table from internal/matrix/versions.yaml, and CI fails if it is stale.
With Go 1.26 or newer:
git clone https://github.com/monedula-dev/monedula-gitops.git
cd monedula-gitops
go build ./cmd/monedula-gitops
go test ./...CONTRIBUTING.md lists the lint checks and the end-to-end suites for the CLI (Docker) and the operator (kind and bats).
Report bugs and request features in GitHub issues. Read CONTRIBUTING.md before opening a pull request, and SECURITY.md before reporting a vulnerability. CHANGELOG.md lists the changes in each release.
monedula-gitops is licensed under the AGPL-3.0; see LICENSE and NOTICE. Using it on your own clusters, as a CLI or as an operator in your own infrastructure, does not oblige you to share your code or manifests: AGPL obligations apply when you distribute it, modified or not, or let others use a modified version over a network. For commercial licensing, contact us.
Apache Kafka, Kafka and the Kafka logo are trademarks of The Apache Software Foundation. monedula-gitops is an independent project that works with Kafka clusters; it is not affiliated with, endorsed by or sponsored by the ASF.