Cluster Registration
In Development (Q4 2026)
This feature is currently in development. Registration workflows described here are subject to change.
Purpose: For platform engineers, describes how to register existing openCenter clusters into a managed fleet.
Registration Flow
- Generate registration token on hub cluster
- Install fleet agent on spoke cluster using token
- Agent connects to hub and reports cluster metadata
- Hub registers cluster with labels and group assignments
- Fleet operations become available for the registered cluster
Generate Token
opencenter fleet token create \
--cluster-name "prod-us-east-01" \
--labels "environment=production,region=us-east,provider=openstack" \
--ttl 24h
Install Agent
opencenter fleet join \
--hub-url "https://fleet.example.com" \
--token "<registration-token>" \
--cluster-name "prod-us-east-01"
This deploys the fleet agent into the opencenter-fleet-system namespace on the spoke cluster.
Cluster Labels
Labels are used for grouping and targeting:
| Label | Purpose | Example |
|---|---|---|
environment | Deployment stage | production, staging, dev |
region | Geographic location | us-east, eu-west, ap-south |
provider | Infrastructure provider | openstack, vmware, baremetal |
tier | Service tier | critical, standard |
blueprint | Active blueprint | finance, healthcare, telco |
Deregistration
opencenter fleet leave --cluster-name "prod-us-east-01"
This removes the agent and unregisters the cluster from the hub. Workloads on the spoke cluster are unaffected.