How aquasecurity/trivy-operator works
Trivy Operator watches Kubernetes resources and responds to changes with scans, then publishes findings as Kubernetes-native custom-resource reports. The principal workload path is reconciliation, scan-job construction, Trivy execution, report building, and API persistence. Separate branches cover configuration and policy audits, RBAC, infrastructure, compliance, SBOMs, exposed secrets, metrics, and webhook delivery. The README documents several capabilities not fully sampled; edges for those rely on its statements, and unsampled implementation details are not asserted.
Main entry points: operator.go Operator manager · workload.go Workload reconciler · scanjob.go Scan-job controller · resource.go Config audit controller
Components 21
Operator control
- Operator manager
pkg/operator/operator.go - Operator configuration
pkg/operator/etc/config.go - Object resolver
pkg/kube/object.go
Workload scanning
- Workload reconciler
pkg/vulnerabilityreport/controller/workload.go - Scan-job controller
pkg/vulnerabilityreport/controller/scanjob.go - Scan-job builder
pkg/vulnerabilityreport/builder.go - Trivy scan plugin
pkg/plugins/trivy/image.go
Cluster assessments
- Config audit controller
pkg/configauditreport/controller/resource.go - Policy evaluation
pkg/policy/policy.go - Infrastructure assessment
pkg/infraassessment/builder.go - RBAC assessment
pkg/rbacassessment/builder.go - Compliance reports
pkg/compliance/io.go
Reports and APIs
- SBOM reports
pkg/sbomreport/builder.go - Vulnerability reports
pkg/vulnerabilityreport/builder.go - Report resource types
pkg/apis/aquasecurity/v1alpha1/vulnerability_types.go
Observability and delivery
- Prometheus metrics
pkg/metrics/collector.go - Webhook reporter
pkg/webhook/webhookreporter.go
Other components
- Cluster changes
- Kubernetes API
- Trivy scanner
- Webhook endpoint
Connections 26
- Cluster changes → Kubernetes API: changes resources
- Kubernetes API → Operator manager: notifies changes
- Operator manager → Operator configuration: loads configuration
- Operator manager → Workload reconciler: sets up controller
pkg/operator/operator.go - Operator manager → Config audit controller: sets up controller
pkg/operator/operator.go - Operator manager → Prometheus metrics: registers collector
pkg/operator/operator.go - Workload reconciler → Object resolver: resolves owners
pkg/vulnerabilityreport/controller/workload.go - Workload reconciler → Scan-job controller: handles completed jobs
pkg/vulnerabilityreport/controller/workload.go - Workload reconciler → Scan-job builder: builds scan jobs
- Scan-job builder → Trivy scan plugin: requests job spec
pkg/vulnerabilityreport/builder.go - Trivy scan plugin → Trivy scanner: runs scans
- Scan-job controller → Vulnerability reports: builds findings
pkg/vulnerabilityreport/controller/scanjob.go - Scan-job controller → SBOM reports: builds SBOM reports
pkg/vulnerabilityreport/controller/scanjob.go - Scan-job controller → Report resource types: persists report resources
- Config audit controller → Policy evaluation: evaluates policies
pkg/configauditreport/controller/resource.go - Config audit controller → Infrastructure assessment: creates assessment reports
pkg/configauditreport/controller/resource.go - Config audit controller → RBAC assessment: runs RBAC assessment
pkg/configauditreport/controller/resource.go - Operator manager → Compliance reports: sets up reporting
pkg/operator/operator.go - Operator manager → Report resource types: registers report types
- Prometheus metrics → Kubernetes API: reads reports
pkg/metrics/collector.go - Webhook reporter → Webhook endpoint: posts report events
pkg/webhook/webhookreporter.go - Vulnerability reports → Kubernetes API: publishes reports
- SBOM reports → Kubernetes API: publishes reports
- Infrastructure assessment → Kubernetes API: publishes reports
- RBAC assessment → Kubernetes API: publishes reports
- Compliance reports → Kubernetes API: publishes reports