Skip to content

xCloud Kube

Overview

xCloud Kube is a managed Kubernetes service for running your container workloads. You provision clusters in the xCloud web app, pick a size (flavor) and a Kubernetes version, and xCloud handles the control plane, node infrastructure, and lifecycle operations. Billing is consumption-based: you choose a maximum cluster size, but you are billed for the resources you actually use.

Typical use cases:

  • Hosting containerised applications without operating Kubernetes infrastructure yourself
  • Spinning up isolated test or staging clusters on demand
  • Running workloads that need a redundant control plane via the optional high-availability option

Getting Started

Prerequisites

  • An active xCloud account with complete billing details
  • A configured payment method
  • Basic familiarity with Kubernetes concepts (clusters, kubeconfig, kubectl)

Activating xCloud Kube

Before you can create clusters, the xCloud Kube subscription must be activated for your account:

  1. Open the xCloud Kube section in the xCloud dashboard
  2. Review the available cluster sizes and the Price details for each one
  3. Click Activate and accept the Terms of Service

Once activated, the cluster dashboard becomes available and you can create your first cluster.

Creating a Cluster

Click Create cluster to open the cluster creation dialog. The form is grouped into the following sections.

Step 1: Select Site

Choose the geographic location where the cluster will be provisioned. The site determines where your control plane and worker nodes run.

Step 2: Select Cluster Size

Cluster sizes (flavors) define the maximum resources available to the cluster:

  • vCPU: number of CPU cores
  • RAM: memory allocation
  • Ephemeral storage: node-local scratch storage
  • Pods: maximum number of pods

Billing model

The cluster size defines the maximum resource limit. Only actual consumption (usage and requests) is billed.

Step 3: Persistent Storage

Optionally allocate persistent storage for the cluster (1–1000 GB). Persistent storage is required if your workloads use PersistentVolumeClaim resources. Leave the field empty if you do not need persistent storage.

Step 4: High Availability

Enable High availability to provision a redundant control plane with increased fault tolerance. The price difference is shown next to the checkbox.

Warning

High availability cannot be changed after the cluster has been created. To switch later, you must create a new cluster.

Step 5: Basic Settings

  • Cluster name: must start with a lowercase letter and may only contain lowercase letters, digits, and hyphens (DNS-safe format)
  • Kubernetes version: select from the list of currently supported versions

Step 6: Complete the Order

The dialog shows the estimated monthly cost at maximum usage. Review the legal terms and click Order at cost to start provisioning. The new cluster appears in the dashboard with status Requested and progresses through the lifecycle states described below.

Managing Clusters

Cluster Dashboard

The dashboard lists every cluster in your account with the following columns:

  • Name: the cluster name you chose at creation
  • Version: the Kubernetes version currently running
  • Endpoint: the Kubernetes API server URL (with a copy-to-clipboard button)
  • Created at: timestamp of creation
  • State: the current lifecycle state (see below)

Cluster States

State Description
Requested Creation request received, not yet picked up
Pending Waiting for provisioning to start
Creating Cluster is being provisioned
Active Cluster is fully operational
Updating Configuration change or version upgrade in progress
Deleting Cluster is being torn down
Error Provisioning or an operation failed

Most actions are only available while a cluster is Active. Deletion is also available in the Pending state.

Cluster Actions

Each row in the dashboard exposes an actions menu:

  • View details: read-only overview of cluster configuration, current resource usage, and forecasted cost
  • Edit: change cluster size, persistent storage, or Kubernetes version (only when Active)
  • Price details: granular price breakdown for the cluster's current flavor
  • Download kubeconfig: download the credentials file needed by kubectl (only when Active)
  • Delete cluster: permanently remove the cluster and all its data

Accessing the Cluster

Once a cluster is Active, download the kubeconfig file from the actions menu and point your tooling at it:

export KUBECONFIG=~/Downloads/<cluster-name>-kubeconfig.yaml
kubectl get nodes

The kubeconfig contains the API endpoint and credentials needed to manage workloads in the cluster. Keep it secure — anyone with the file can administer the cluster.

Info

Kubeconfig download is only available once the cluster reaches the Active state. While provisioning, the action is disabled.

Editing a Cluster

Open the cluster's actions menu and choose Edit to modify the configuration. The following fields are editable while the cluster is Active:

  • Cluster size: resize up or down to a different flavor
  • Persistent storage: increase or decrease the allocation
  • Kubernetes version: upgrade to a newer supported version

The following fields are fixed at creation time and shown as read-only: cluster name, site, high availability, creation date.

Resource Usage Awareness

While editing, the dialog shows live resource usage (CPU, RAM, ephemeral storage, persistent storage) against the current limits. If you choose a smaller flavor or storage allocation than what the cluster is currently using, a warning is displayed — proceeding may cause the cluster to suffer from resource scarcity.

Kubernetes Version Upgrades

  • Only upgrades are supported. Downgrades are not possible, and older versions are disabled in the dropdown.
  • The upgrade operation is safe: it either completes successfully or aborts cleanly without affecting cluster availability.
  • An upgrade puts the cluster into the Updating state while it runs.

Save changes with the Save changes button. The cluster transitions to Updating while the new configuration is rolled out.

Monitoring Resource Usage

Open View details for any Active cluster to see current usage:

  • CPU (vCPU): cores currently consumed vs. flavor maximum
  • RAM (GB): memory currently consumed vs. flavor maximum
  • Ephemeral storage (GB): node-local storage in use vs. flavor maximum
  • Persistent storage (GB): persistent volume usage vs. allocated storage

The same dialog displays:

  • Monthly cost at maximum usage: what you would pay if the cluster ran at the flavor's full limit
  • Forecasted monthly cost: projection based on current consumption

Deleting a Cluster

  1. Open the actions menu for the cluster
  2. Select Delete cluster
  3. Confirm the deletion in the dialog

Irreversible

Deleting a cluster permanently removes all data and workloads. This action cannot be undone. Back up anything you need before deleting.

Deletion is available in the Active and Pending states.

Pricing

xCloud Kube uses a consumption-based pricing model. The cluster size defines the upper bound on resources; you are billed for actual usage rather than the maximum.

Charges are composed of:

  • Compute resources: per-core hourly rate for CPU, per-GB hourly rate for RAM
  • Ephemeral storage: per-GB hourly rate
  • Control plane: flat hourly fee (standard) or higher flat fee (high availability)
  • Persistent storage: per-GB hourly rate, billed on the allocated volume
  • Egress traffic: tiered per-GB pricing; the first 1000 GB per month are included

Prices are shown including VAT for private customers and excluding VAT for business customers. The Price details dialog (accessible per cluster or from the activation view) breaks the costs down by resource.

Cancelling the Subscription

To deactivate xCloud Kube entirely:

  1. Delete all clusters in your account (cancellation is blocked while clusters exist)
  2. Open the xCloud Kube section
  3. Click Deactivate xCloud Kube and confirm

The change takes effect within a few minutes. You can re-activate the subscription later if needed.

Troubleshooting

Cluster Stuck in Creating

Provisioning typically takes a few minutes. If the cluster remains in Creating for an extended period, check the dashboard for an Error state and contact support if needed.

Kubeconfig Download Unavailable

The kubeconfig is only available once the cluster reaches the Active state. Wait for provisioning to finish before attempting to download.

Cannot Cancel Subscription

The deactivation button is disabled while any clusters exist on the account. Delete all clusters first, then retry the cancellation.

Resource Pressure After Resize

If a cluster is sluggish or workloads are being evicted after a resize, the new flavor may be smaller than the cluster's actual consumption. Open View details to check current usage, and edit the cluster to select a larger flavor if needed.