controller

Overview ¶

Package controller implements the main Kubernetes controller for managing the OpenShift Lightspeed operator lifecycle.

This package contains the OLSConfigReconciler, which is the central orchestrator for the entire operator. It coordinates reconciliation across all components (appserver/lcore, postgres, console) and manages the OLSConfig custom resource.

The controller code is organized into multiple files:

• olsconfig_controller.go: Core type definition, Reconcile(), and SetupWithManager()
• olsconfig_helpers.go: Interface implementations, status management, and annotation logic
• olsconfig_watchers.go: Watcher predicate helpers for secrets and configmaps
• operator_assets.go: Operator infrastructure resources (ServiceMonitor, NetworkPolicy)

Key Responsibilities:

• Reconcile the OLSConfig custom resource
• Coordinate component reconciliation (console, postgres, appserver/lcore)
• Manage status conditions and CR status updates
• Set up resource watchers for automatic updates (secrets, configmaps)
• Manage operator-level resources (service monitors, network policies)

The main reconciliation flow:

1. Reconcile operator-level resources (service monitor, network policy)
2. Handle finalizer logic (cleanup on deletion, add on creation)
3. Fetch and validate OLSConfig CR
4. Annotate external resources for change tracking
5. Phase 1: Reconcile independent resources (ConfigMaps, Secrets, ServiceAccounts, etc.)
6. Phase 2: Reconcile deployments and dependent resources (Services, TLS certs, etc.)
7. Update status conditions based on deployment readiness

The OLSConfigReconciler implements the reconciler.Reconciler interface, allowing it to be passed to component packages for isolated reconciliation without circular dependencies.