How caapim/layer7-operator works
Layer7 Gateway Operator is a Kubernetes operator for deploying, maintaining, and upgrading Layer7 API Gateways. Its principal workflow starts when a user creates or changes a Kubernetes custom resource; a controller reconciles that resource and applies the desired cluster state. Separate controllers handle Gateway infrastructure, API deployment, repositories, portals, and state stores. API deployment and repository synchronization also involve bundle/Graphman processing and state persistence. The graph reflects documented capabilities and shown controller calls; some internal links are dashed because the relevant implementation was not excerpted.
Main entry points: l7api.go API deployment · repository.go Repository sync · gateway/controller.go Gateway controller · api/controller.go API controller
Components 24
Resource Controllers
- Gateway resource
api/v1/gateway_types.go - L7Api resource
api/v1alpha1/l7api_types.go - Repository resource
api/v1/repository_types.go - L7Portal resource
api/v1alpha1/l7portal_types.go - L7StateStore resource
api/v1alpha1/l7statestore_types.go - Gateway controller
internal/controller/gateway/controller.go - API controller
internal/controller/api/controller.go - Repository controller
internal/controller/repository/controller.go - Portal controller
internal/controller/portal/controller.go - State controller
internal/controller/statestore/controller.go
Gateway Runtime
- Gateway reconciliation
pkg/gateway/reconcile/gateway.go - Gateway services
pkg/gateway/service.go
API Deployment
- API deployment
pkg/api/reconcile/l7api.go - API bundle tools
pkg/api/bundle.go - Portal templates
internal/templategen/templategen.go
Content Sources
- Graphman processing
internal/graphman/graphman.go - Bundle utilities
pkg/util/bundle.go - Repository sync
pkg/repository/reconcile/repository.go - Repository state storage
pkg/repository/reconcile/statestorage.go
Portal And State
- Portal jobs
pkg/portal/reconcile/portal.go - State store setup
pkg/statestore/reconcile/statestore.go - Redis state store
Other components
- Kubernetes user
- Kubernetes API
Connections 26
- Kubernetes user → Kubernetes API: applies resources
README.md - Kubernetes API → Gateway controller: triggers reconcile
internal/controller/gateway/controller.go - Kubernetes API → API controller: triggers reconcile
internal/controller/api/controller.go - Kubernetes API → Repository controller: triggers reconcile
internal/controller/repository/controller.go - Kubernetes API → Portal controller: triggers reconcile
internal/controller/portal/controller.go - Kubernetes API → State controller: triggers reconcile
internal/controller/statestore/controller.go - Gateway resource → Kubernetes API: stored in
README.md - L7Api resource → Kubernetes API: stored in
- Repository resource → Kubernetes API: stored in
- L7Portal resource → Kubernetes API: stored in
- L7StateStore resource → Kubernetes API: stored in
- Gateway controller → Gateway reconciliation: runs operations
- Gateway reconciliation → Gateway services: creates desired services
- Gateway controller → Kubernetes API: reads resources
internal/controller/gateway/controller.go - API controller → API deployment: calls reconcile steps
internal/controller/api/controller.go - API deployment → API bundle tools: uses bundle tools
- API deployment → Portal templates: builds policy templates
pkg/api/reconcile/l7api.go - API deployment → Kubernetes API: deploys to gateways
pkg/api/reconcile/l7api.go - Repository controller → Repository sync: runs sync steps
- Repository sync → Bundle utilities: validates bundles
pkg/repository/reconcile/repository.go - Repository sync → Graphman processing: uses Graphman
- Repository sync → Repository state storage: reconciles state
- Repository state storage → Redis state store: reads and writes
pkg/repository/reconcile/statestorage.go - Portal controller → Portal jobs: runs portal jobs
internal/controller/portal/controller.go - State controller → State store setup: sets up state store
internal/controller/statestore/controller.go - State store setup → Redis state store: configures Redis