Overview
Xloud Kubernetes as a Service (K8SaaS) automates the full lifecycle of Kubernetes clusters on top of Xloud infrastructure services. The platform is built around a Conductor that orchestrates cluster create, update, delete, and upgrade operations by composing calls to Compute, Load Balancer, DNS, and Networking services through Xloud Orchestration templates.Component Architecture
Components
K8SaaS API
K8SaaS API
RESTful API that accepts cluster lifecycle requests (create, update, delete, upgrade,
config). Validates requests, stores state in the K8SaaS database, and dispatches
async tasks to the Conductor.Deployed as:
magnum_api container on controller nodes, behind the load balancer.Conductor
Conductor
Long-running worker that executes cluster lifecycle operations. For each operation,
it creates or updates an Orchestration stack, monitors stack progress, and updates
cluster status in the database.Deployed as:
magnum_conductor container on controller nodes. Multiple conductors
can run for horizontal scaling — each claims tasks from the queue.Cluster Database
Cluster Database
Stores cluster definitions, template configurations, node group state, and cluster
CA private keys. Backed by the platform MariaDB instance.Schema includes:
cluster, cluster_template, nodegroup, x509keypair tables.Orchestration Templates
Orchestration Templates
Each cluster driver (kubernetes) ships Heat templates that describe the full cluster
resource stack: VM instances, network ports, floating IPs, security groups, LB members,
and node bootstrap scripts.Template location:
/usr/lib/python3/dist-packages/magnum/drivers/k8s_fedora_coreos_v1/templates/Cluster Provisioning Flow
Infrastructure Dependencies
| Service | Role | Minimum Version |
|---|---|---|
| Xloud Compute | VM instances for master and worker nodes | 2025.1 |
| Xloud Orchestration | Stack management for cluster resources | 2025.1 |
| Xloud Load Balancer | API server VIP and Kubernetes service LBs | 2025.1 |
| Xloud Networking | Tenant subnet allocation for cluster nodes | 2025.1 |
| Xloud DNS | Endpoint records for ingress and services | Optional |
| Xloud Block Storage | Persistent volume claims for stateful workloads | 2025.1 |
| Xloud Key Management | Cluster CA private key storage (optional) | Optional |
Deployment Topology
Controller Nodes
magnum_api — REST API
magnum_conductor — Lifecycle orchestration
Cluster Nodes (per cluster)
Master Nodes
Worker Nodes
Next Steps
Cluster Drivers
Configure and verify the Kubernetes cluster driver.
Template Management
Create and manage public cluster templates for project teams.
Quotas
Set per-project cluster and node count limits.
Security
Configure TLS, RBAC, and node security groups.