How osac-project/osac works
OSAC is a multi-tenant cloud platform. Users provision cloud resources through its CLI, web UI, or gRPC/REST API; the fulfillment service manages resource state, and Kubernetes operators reconcile resources and invoke infrastructure automation. The repository also includes bare-metal provisioning, storage integration, CSI routing, and a metering pipeline. Cross-component links below rely on README statements; sampled source confirms selected storage, bare-metal, and CSI responsibilities, but does not expose every runtime connection.
Main entry points: servers gRPC and REST API · controller OSAC operator · private_storage_backends_server.go Storage backend API · controller.go OSAC CSI driver
Components 22
Fulfillment control plane
- gRPC and REST API
fulfillment-service/internal/servers - Tenant auth and RBAC
fulfillment-service/internal/auth - PostgreSQL state
fulfillment-service/internal/database - Resource controllers
fulfillment-service/internal/controllers
Provisioning and infrastructure
- Bare-metal resources
bare-metal-fulfillment-operator/api/v1alpha1/baremetalinstance_types.go - Bare-metal reconciler
bare-metal-fulfillment-operator/internal/controller/baremetalinstance_controller.go - Host management
bare-metal-fulfillment-operator/internal/baremetalhost/manager.go - OSAC operator
osac-operator/internal/controller - AAP automation
osac-aap - Cloud infrastructure
Storage services
- Storage reconciler
osac-operator/internal/controller/storage_controller.go - Storage backend API
fulfillment-service/internal/servers/private_storage_backends_server.go - Storage admin UI
osac-ui/libs/ui-components/src/components/Storage/StorageTierCreatePage.tsx - OSAC CSI driver
osac-csi-driver/pkg/driver/controller.go - Vendor CSI drivers
Metering
- Metering service
osac-metering/metering-service/cmd/metering-service/main.go - Kafka
- Billing adapters
osac-metering/adapters
Other components
- Cloud user
- Model inference service
Connections 23
- Cloud user → OSAC CLI: uses
README.md - Cloud user → Web UI: uses
README.md - Cloud user → gRPC and REST API: automates through
README.md - OSAC CLI → gRPC and REST API: calls
README.md - Web UI → gRPC and REST API: uses
- gRPC and REST API → Tenant auth and RBAC: authorizes
README.md - gRPC and REST API → PostgreSQL state: stores state
README.md - gRPC and REST API → Resource controllers: manages resources
README.md - Resource controllers → OSAC operator: creates resources
README.md - OSAC operator → AAP automation: triggers jobs
README.md - AAP automation → Cloud infrastructure: provisions
README.md - Cloud user → Bare-metal resources: requests hosts
README.md - Bare-metal resources → Bare-metal reconciler: reconciled by
- Bare-metal reconciler → Host management: manages hosts
- OSAC operator → Storage reconciler: reconciles storage
README.md - Storage admin UI → Storage backend API: manages backends
- Storage backend API → PostgreSQL state: persists records
fulfillment-service/internal/servers/private_storage_backends_server.go - OSAC CSI driver → Storage backend API: resolves storage tiers
README.md - OSAC CSI driver → Vendor CSI drivers: routes requests
README.md - Metering service → gRPC and REST API: watches events
README.md - Metering service → Kafka: publishes events
README.md - Kafka → Billing adapters: feeds billing
README.md - Cloud user → Model inference service: requests inference
README.md