Skip to main content

Overview

Administrators create and publish public cluster templates that are shared across all projects. Public templates provide standardized, pre-approved Kubernetes configurations — ensuring project teams use consistent Kubernetes versions, flavors, and network drivers without needing to configure templates themselves. This page covers creating, updating, and retiring public templates.
Changes to public templates do not affect clusters already deployed from those templates. However, all new clusters created from an updated template will use the new configuration.

Public vs Private Templates

TypeVisibilityCreated ByUsed By
PublicAll projectsAdministratorAny project team
PrivateCurrent project onlyAny userOwn project only

Create a Public Template

Navigate to Cluster Templates (admin)

Log in to the Xloud Dashboard (https://connect.<your-domain>) and navigate to Admin → Containers → Cluster Templates.

Create template

Click Create Cluster Template and fill in the fields. Set Public to True.
FieldRecommended ValueNotes
Master Flavorm1.xlargeControl plane: 8 vCPU / 16 GB minimum
Master LB EnabledTrueRequired for HA control plane
Network DrivercalicoNetworkPolicy enforcement for production
Volume DrivercinderEnables PersistentVolumeClaims
Docker Volume Size50 GBContainer image storage per node
Floating IP EnabledTruekubectl access via floating IP
PublicTrueShare across all projects

Add auto-healing labels

In the Labels field, add:
auto_healing_enabled=true
This enables automatic node replacement when a node becomes unhealthy.

Save

Click Create Cluster Template. The template appears in all project template lists immediately.
Template is visible in all projects and usable for cluster creation.

Template Version Lifecycle

Maintain a clear versioning strategy for public templates as Kubernetes versions are released and deprecated.
StageAction
New version availableCreate new public template (e.g., k8s-1.30-standard)
Previous version stableKeep both templates public — users can choose
Previous version deprecatedMark old template as non-public; notify project teams
Previous version retiredDelete old template after all clusters have been upgraded
Make an existing template private (deprecation)
openstack coe cluster template update k8s-1.28-standard \
  replace public=False
Delete a retired template
openstack coe cluster template delete k8s-1.28-standard
Templates referenced by active clusters cannot be deleted. All clusters using a template must be upgraded or deleted before the template can be removed.

Labels control advanced Kubernetes and platform features at the template level.
LabelValueEffect
auto_healing_enabledtrueAutomatically replace unhealthy nodes
auto_scaling_enabledtrueEnable Cluster Autoscaler
container_runtimecontainerdSet container runtime (required for Kubernetes 1.24+)
cloud_provider_enabledtrueEnable Xloud cloud provider for LoadBalancer services
cinder_csi_enabledtrueEnable Cinder CSI driver for PersistentVolumeClaims

Validation

Navigate to a non-admin project and check Project → Containers → Cluster Templates. Verify the public template is visible and selectable for cluster creation.
Public template is visible in all projects and usable for cluster creation.

Next Steps

Quotas

Set per-project limits on cluster and node counts.

Container Runtime

Configure the recommended container runtime for new templates.

Network Drivers

Choose CNI plugins and configure NetworkPolicy defaults.

Certificates

Manage cluster certificate authorities and perform CA rotations.