Cluster lifecycle controller for ROSA HCP. Watches Custom Resources backed by PostgreSQL (via pgruntime) and writes DynamoDB desires that kube-applier-aws applies to management clusters.
See docs/architecture.md for the full design and per-controller documentation.
- Go 1.24+
- Container runtime (podman or docker) — for integration tests (Postgres + DynamoDB Local)
make help # list all targets
make test # unit tests
make test-integration # integration tests (Postgres + DynamoDB Local containers)
make manifests # regenerate CRDs from Go types
make build # build the operator binaryThe operator requires two AWS resources at runtime:
The operator stores all Custom Resources in PostgreSQL via pgruntime. The connection string is provided via the POSTGRES_DSN environment variable.
The operator reads and writes DynamoDB tables using IAM credentials. See docs/quickstart.md for the full permissions table and table setup.
Run make help for all available targets. Run make test before pushing changes. See docs/architecture.md for design context and the individual controller docs for flow details.
Copyright 2026. Licensed under the Apache License, Version 2.0.