# dana-team/container-app-operator architecture

> Architecture diagram of the GitHub repository dana-team/container-app-operator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dana-team/container-app-operator
- Repository: https://github.com/dana-team/container-app-operator

## Overview

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: [`internal/kinds/capp/controllers/controller.go`](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/controllers/controller.go) (Capp reconciler), [`api/v1alpha1/capp_types.go`](https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/capp_types.go) (Capp resources), [`cmd/main.go`](https://github.com/dana-team/container-app-operator/blob/main/cmd/main.go) (Operator manager), [`internal/kinds/capprevision/controllers/controller.go`](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/controllers/controller.go) (Revision reconciler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Capp API"]
  node_capp_types["Capp resources<br/>[capp_types.go]"]
  node_config_types["Capp config"]
  node_revision_types["Revision resources"]
end

subgraph group_control["Reconciliation"]
  node_manager["Operator manager<br/>[main.go]"]
  node_capp_controller["Capp reconciler<br/>[controller.go]"]
  node_revision_controller["Revision reconciler<br/>[controller.go]"]
end

subgraph group_resources["Managed resources"]
  node_resource_client["Resource client<br/>[resourceclient.go]"]
  node_ksvc["Knative service<br/>[ksvc.go]"]
  node_routing["Domain and DNS"]
  node_certs["Certificates<br/>[certificate.go]"]
  node_logging["Log shipping<br/>[syslogngflow.go]"]
  node_log_output["Log outputs<br/>[syslogngoutput.go]"]
  node_event_sources["Event sources"]
  node_nfs["NFS volumes<br/>[nfspvc.go]"]
end

subgraph group_lifecycle["Lifecycle and status"]
  node_revision_actions["Revision actions<br/>[update.go]"]
  node_revision_adapter["Revision adapter"]
  node_rollout["Rollout state machine<br/>[rollout.go]"]
  node_status["Capp status<br/>[capp.go]"]
end

subgraph group_admission["Admission"]
  node_webhook["Admission webhooks"]
end

node_user(("Capp user"))
node_external_platform[("Kubernetes platform")]
node_external_controllers["Platform controllers"]

node_user -->|"submits"| node_capp_types
node_manager -->|"starts"| node_capp_controller
node_manager -->|"starts"| node_revision_controller
node_manager -->|"registers"| node_webhook
node_webhook -->|"validates and mutates"| node_capp_types
node_capp_controller -->|"reads"| node_capp_types
node_capp_controller -->|"loads config"| node_config_types
node_capp_controller -->|"reconciles"| node_ksvc
node_capp_controller -.->|"reconciles"| node_routing
node_capp_controller -.->|"reconciles"| node_certs
node_capp_controller -.->|"reconciles"| node_logging
node_capp_controller -.->|"reconciles"| node_log_output
node_capp_controller -.->|"reconciles"| node_event_sources
node_capp_controller -.->|"reconciles"| node_nfs
node_capp_controller -->|"uses"| node_resource_client
node_resource_client -->|"writes resources"| node_external_platform
node_ksvc -->|"creates service"| node_external_platform
node_routing -->|"creates route and DNS"| node_external_platform
node_certs -.->|"manages certificates"| node_external_platform
node_logging -->|"configures log flow"| node_external_controllers
node_log_output -->|"configures output"| node_external_controllers
node_event_sources -->|"creates sources"| node_external_platform
node_nfs -->|"requests NFS storage"| node_external_platform
node_revision_controller -->|"reads Capp"| node_capp_types
node_revision_controller -->|"dispatches"| node_revision_actions
node_revision_actions -->|"creates and deletes"| node_revision_adapter
node_revision_adapter -->|"manages revisions"| node_revision_types
node_revision_adapter -->|"reads and writes"| node_external_platform
node_capp_controller -->|"handles rollout"| node_rollout
node_capp_controller -->|"updates status"| node_status
node_status -->|"reads child state"| node_external_platform

click node_capp_types "https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/capp_types.go"
click node_config_types "https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/cappconfig_types.go"
click node_revision_types "https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/capprevision_types.go"
click node_manager "https://github.com/dana-team/container-app-operator/blob/main/cmd/main.go"
click node_capp_controller "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/controllers/controller.go"
click node_revision_controller "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/controllers/controller.go"
click node_webhook "https://github.com/dana-team/container-app-operator/tree/main/internal/webhook/rcs/v1alpha1"
click node_resource_client "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourceclient/resourceclient.go"
click node_ksvc "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/ksvc.go"
click node_routing "https://github.com/dana-team/container-app-operator/tree/main/internal/kinds/capp/resourcemanagers"
click node_certs "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/certificate.go"
click node_logging "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/syslogngflow.go"
click node_log_output "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/syslogngoutput.go"
click node_event_sources "https://github.com/dana-team/container-app-operator/tree/main/internal/kinds/capp/resourcemanagers"
click node_nfs "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/nfspvc.go"
click node_revision_actions "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/actionmanagers/update.go"
click node_revision_adapter "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/adapters/capprevision_adapter.go"
click node_rollout "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/rollout/rollout.go"
click node_status "https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/status/capp.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_capp_types,node_config_types,node_revision_types,node_user toneBlue
class node_manager,node_capp_controller,node_revision_controller,node_external_platform toneAmber
class node_resource_client,node_ksvc,node_routing,node_certs,node_logging,node_log_output,node_event_sources,node_nfs toneMint
class node_revision_actions,node_revision_adapter,node_rollout,node_status toneRose
class node_webhook,node_external_controllers toneIndigo
```

## Components

### Capp API

- [Capp resources](https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/capp_types.go): `api/v1alpha1/capp_types.go`
- [Capp config](https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/cappconfig_types.go): `api/v1alpha1/cappconfig_types.go`
- [Revision resources](https://github.com/dana-team/container-app-operator/blob/main/api/v1alpha1/capprevision_types.go): `api/v1alpha1/capprevision_types.go`

### Reconciliation

- [Operator manager](https://github.com/dana-team/container-app-operator/blob/main/cmd/main.go): `cmd/main.go`
- [Capp reconciler](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/controllers/controller.go): `internal/kinds/capp/controllers/controller.go`
- [Revision reconciler](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/controllers/controller.go): `internal/kinds/capprevision/controllers/controller.go`

### Managed resources

- [Resource client](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourceclient/resourceclient.go): `internal/kinds/capp/resourceclient/resourceclient.go`
- [Knative service](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/ksvc.go): `internal/kinds/capp/resourcemanagers/ksvc.go`
- [Domain and DNS](https://github.com/dana-team/container-app-operator/tree/main/internal/kinds/capp/resourcemanagers): `internal/kinds/capp/resourcemanagers`
- [Certificates](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/certificate.go): `internal/kinds/capp/resourcemanagers/certificate.go`
- [Log shipping](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/syslogngflow.go): `internal/kinds/capp/resourcemanagers/syslogngflow.go`
- [Log outputs](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/syslogngoutput.go): `internal/kinds/capp/resourcemanagers/syslogngoutput.go`
- [Event sources](https://github.com/dana-team/container-app-operator/tree/main/internal/kinds/capp/resourcemanagers): `internal/kinds/capp/resourcemanagers`
- [NFS volumes](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/resourcemanagers/nfspvc.go): `internal/kinds/capp/resourcemanagers/nfspvc.go`

### Lifecycle and status

- [Revision actions](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/actionmanagers/update.go): `internal/kinds/capprevision/actionmanagers/update.go`
- [Revision adapter](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capprevision/adapters/capprevision_adapter.go): `internal/kinds/capprevision/adapters/capprevision_adapter.go`
- [Rollout state machine](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/rollout/rollout.go): `internal/kinds/capp/rollout/rollout.go`
- [Capp status](https://github.com/dana-team/container-app-operator/blob/main/internal/kinds/capp/status/capp.go): `internal/kinds/capp/status/capp.go`

### Admission

- [Admission webhooks](https://github.com/dana-team/container-app-operator/tree/main/internal/webhook/rcs/v1alpha1): `internal/webhook/rcs/v1alpha1`

### Other components

- **Capp user**
- **Kubernetes platform**
- **Platform controllers**

## Connections

- Capp user → Capp resources: submits (evidence: `README.md`)
- Operator manager → Capp reconciler: starts (evidence: `cmd/main.go`)
- Operator manager → Revision reconciler: starts (evidence: `cmd/main.go`)
- Operator manager → Admission webhooks: registers (evidence: `cmd/main.go`)
- Admission webhooks → Capp resources: validates and mutates (evidence: `internal/webhook/rcs/v1alpha1/mutator.go`)
- Capp reconciler → Capp resources: reads (evidence: `internal/kinds/capp/controllers/controller.go`)
- Capp reconciler → Capp config: loads config (evidence: `internal/kinds/capp/controllers/controller.go`)
- Capp reconciler → Knative service: reconciles (evidence: `internal/kinds/capp/controllers/controller.go`)
- Capp reconciler → Domain and DNS: reconciles (evidence: `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 (evidence: `internal/kinds/capp/controllers/controller.go`)
- Capp reconciler → NFS volumes: reconciles
- Capp reconciler → Resource client: uses (evidence: `internal/kinds/capp/controllers/controller.go`)
- Resource client → Kubernetes platform: writes resources (evidence: `internal/kinds/capp/resourceclient/resourceclient.go`)
- Knative service → Kubernetes platform: creates service (evidence: `README.md`)
- Domain and DNS → Kubernetes platform: creates route and DNS (evidence: `README.md`)
- Certificates → Kubernetes platform: manages certificates
- Log shipping → Platform controllers: configures log flow (evidence: `README.md`)
- Log outputs → Platform controllers: configures output (evidence: `README.md`)
- Event sources → Kubernetes platform: creates sources (evidence: `README.md`)
- NFS volumes → Kubernetes platform: requests NFS storage (evidence: `README.md`)
- Revision reconciler → Capp resources: reads Capp (evidence: `internal/kinds/capprevision/controllers/controller.go`)
- Revision reconciler → Revision actions: dispatches (evidence: `internal/kinds/capprevision/controllers/controller.go`)
- Revision actions → Revision adapter: creates and deletes (evidence: `internal/kinds/capprevision/actionmanagers/update.go`)
- Revision adapter → Revision resources: manages revisions (evidence: `internal/kinds/capprevision/adapters/capprevision_adapter.go`)
- Revision adapter → Kubernetes platform: reads and writes (evidence: `internal/kinds/capprevision/adapters/capprevision_adapter.go`)
- Capp reconciler → Rollout state machine: handles rollout
- Capp reconciler → Capp status: updates status (evidence: `internal/kinds/capp/controllers/controller.go`)
- Capp status → Kubernetes platform: reads child state
