How dana-team/container-app-operator works
Container-app-operator is a Kubernetes operator for the higher-level Capp serverless workload API. Users submit Capp resources; admission mutation and validation run before the Capp controller reconciles desired state into Knative, routing, DNS, certificate, logging, event-source, and storage resources, then reports status. Separate controllers track Capp revisions and staged rollouts. Edges are limited to calls/imports shown in the source index, excerpts, or documented README relationships; several external controllers are capabilities documented by the README, not inspected implementation.
Main entry points: controllers/controller.go Capp reconciler · capp_types.go Capp resources · main.go Operator manager · controllers/controller.go Revision reconciler
Components 22
Capp API
- Capp resources
api/v1alpha1/capp_types.go - Capp config
api/v1alpha1/cappconfig_types.go - Revision resources
api/v1alpha1/capprevision_types.go
Reconciliation
- Operator manager
cmd/main.go - Capp reconciler
internal/kinds/capp/controllers/controller.go - Revision reconciler
internal/kinds/capprevision/controllers/controller.go
Managed resources
- Resource client
internal/kinds/capp/resourceclient/resourceclient.go - Knative service
internal/kinds/capp/resourcemanagers/ksvc.go - Domain and DNS
internal/kinds/capp/resourcemanagers - Certificates
internal/kinds/capp/resourcemanagers/certificate.go - Log shipping
internal/kinds/capp/resourcemanagers/syslogngflow.go - Log outputs
internal/kinds/capp/resourcemanagers/syslogngoutput.go - Event sources
internal/kinds/capp/resourcemanagers - NFS volumes
internal/kinds/capp/resourcemanagers/nfspvc.go
Lifecycle and status
- Revision actions
internal/kinds/capprevision/actionmanagers/update.go - Revision adapter
internal/kinds/capprevision/adapters/capprevision_adapter.go - Rollout state machine
internal/kinds/capp/rollout/rollout.go - Capp status
internal/kinds/capp/status/capp.go
Admission
- Admission webhooks
internal/webhook/rcs/v1alpha1
Other components
- Capp user
- Kubernetes platform
- Platform controllers
Connections 31
- Capp user → Capp resources: submits
README.md - Operator manager → Capp reconciler: starts
cmd/main.go - Operator manager → Revision reconciler: starts
cmd/main.go - Operator manager → Admission webhooks: registers
cmd/main.go - Admission webhooks → Capp resources: validates and mutates
internal/webhook/rcs/v1alpha1/mutator.go - Capp reconciler → Capp resources: reads
internal/kinds/capp/controllers/controller.go - Capp reconciler → Capp config: loads config
internal/kinds/capp/controllers/controller.go - Capp reconciler → Knative service: reconciles
internal/kinds/capp/controllers/controller.go - Capp reconciler → Domain and DNS: reconciles
internal/kinds/capp/controllers/controller.go - Capp reconciler → Certificates: reconciles
- Capp reconciler → Log shipping: reconciles
- Capp reconciler → Log outputs: reconciles
- Capp reconciler → Event sources: reconciles
internal/kinds/capp/controllers/controller.go - Capp reconciler → NFS volumes: reconciles
- Capp reconciler → Resource client: uses
internal/kinds/capp/controllers/controller.go - Resource client → Kubernetes platform: writes resources
internal/kinds/capp/resourceclient/resourceclient.go - Knative service → Kubernetes platform: creates service
README.md - Domain and DNS → Kubernetes platform: creates route and DNS
README.md - Certificates → Kubernetes platform: manages certificates
- Log shipping → Platform controllers: configures log flow
README.md - Log outputs → Platform controllers: configures output
README.md - Event sources → Kubernetes platform: creates sources
README.md - NFS volumes → Kubernetes platform: requests NFS storage
README.md - Revision reconciler → Capp resources: reads Capp
internal/kinds/capprevision/controllers/controller.go - Revision reconciler → Revision actions: dispatches
internal/kinds/capprevision/controllers/controller.go - Revision actions → Revision adapter: creates and deletes
internal/kinds/capprevision/actionmanagers/update.go - Revision adapter → Revision resources: manages revisions
internal/kinds/capprevision/adapters/capprevision_adapter.go - Revision adapter → Kubernetes platform: reads and writes
internal/kinds/capprevision/adapters/capprevision_adapter.go - Capp reconciler → Rollout state machine: handles rollout
- Capp reconciler → Capp status: updates status
internal/kinds/capp/controllers/controller.go - Capp status → Kubernetes platform: reads child state