How oracle/karpenter-provider-oci works
Karpenter Provider OCI provisions and manages OKE worker nodes in response to workload demand. The documented path runs from unschedulable pods and placement constraints through instance-type selection and OCI-backed launch, then feeds registered-node capacity observations back into future sizing. Cloud-provider operations also support node removal and fleet optimization. NodeClass reconciliation manages OCI prerequisites; additional providers cover networking, images, reservations, placement, and related resources. The graph uses README workflow statements and SOURCE INDEX references; unsampled relationships are omitted rather than inferred.
Main entry points: cloud_provider.go Cloud provider · ocinodeclass_controller.go NodeClass reconciliation · operator.go Operator wiring · controllers.go Controller registration
Components 20
Runtime and control
- Application entry
cmd/main.go - Operator wiring
pkg/operator/operator.go - Controller registration
pkg/controllers/controllers.go - Metrics
pkg/metrics/metrics.go
Scheduling and launch
- Cloud provider
pkg/cloudprovider/cloud_provider.go - Instance lifecycle
pkg/providers/instance/provider.go - Instance types
pkg/providers/instancetype/provider.go - Placement proposals
pkg/providers/placement/provider.go
OCI resource management
- OCI clients
pkg/oci/client.go - NodeClass API
pkg/apis/v1beta1/ocinodeclass_types.go - NodeClass reconciliation
pkg/controllers/nodeclasses/ocinodeclass_controller.go - Image provider
pkg/providers/image/provider.go - Network provider
pkg/providers/network/provider.go - Capacity reservations
pkg/providers/capacityreservation/provider.go
Fleet feedback
- Capacity discovery
pkg/providers/capacitydiscovery/provider.go - Discovery controller
pkg/controllers/capacitydiscovery/controller.go - Orphan cleanup
pkg/controllers/orphaninstance/controller.go
Other components
- Workloads
- Kubernetes API
- Oracle Cloud
Connections 26
- Workloads → Cloud provider: trigger provisioning
- Cloud provider → Instance types: select types
pkg/cloudprovider/cloud_provider.go - Cloud provider → Instance lifecycle: manage instances
pkg/cloudprovider/cloud_provider.go - Cloud provider → Placement proposals: request placement
- Instance lifecycle → OCI clients: call OCI
- OCI clients → Oracle Cloud: access services
- Application entry → Operator wiring: create operator
cmd/main.go - Application entry → Cloud provider: construct provider
cmd/main.go - Application entry → Controller registration: register controllers
cmd/main.go - Operator wiring → OCI clients: create clients
pkg/operator/operator.go - Operator wiring → Instance lifecycle: initialize provider
pkg/operator/operator.go - Operator wiring → Instance types: initialize provider
- Controller registration → NodeClass reconciliation: register
pkg/controllers/controllers.go - Controller registration → Discovery controller: register
pkg/controllers/controllers.go - Controller registration → Orphan cleanup: register
pkg/controllers/controllers.go - NodeClass reconciliation → Image provider: resolve images
pkg/controllers/nodeclasses/ocinodeclass_controller.go - NodeClass reconciliation → Network provider: resolve networking
pkg/controllers/nodeclasses/ocinodeclass_controller.go - NodeClass reconciliation → Capacity reservations: resolve reservations
pkg/controllers/nodeclasses/ocinodeclass_controller.go - NodeClass reconciliation → NodeClass API: reconcile resource
pkg/controllers/nodeclasses/ocinodeclass_controller.go - Discovery controller → Cloud provider: read node claims
pkg/controllers/capacitydiscovery/controller.go - Discovery controller → Capacity discovery: record capacity
pkg/controllers/capacitydiscovery/controller.go - Capacity discovery → Instance types: inform sizing
- Orphan cleanup → Cloud provider: list and delete
pkg/controllers/orphaninstance/controller.go - Cloud provider → Metrics: record metrics
- Workloads → Cloud provider: deprovision unused nodes
- Workloads → Cloud provider: consolidate fleet