Skip to content

About

Declarative GitOps for Apache Kafka — topics, ACLs, quotas, schemas, and RBAC.

Topics

Resources

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

Monedula GitOps

CI Release License: AGPL v3 Go Report Card

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

brew install monedula-dev/tap/monedula-gitops

The install page covers go install, Docker, the prebuilt binaries and the operator.

Try it

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 drift

quickstart/cli has a local Kafka and Schema Registry and the manifests to run these commands against.

Runnable examples

Validated versions

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.

Building from source

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).

Contributing and security

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.

License

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.

About

Declarative GitOps for Apache Kafka — topics, ACLs, quotas, schemas, and RBAC.

Topics

Resources

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages