Skip to content

OpenStack Setup

Before deploying Managed Kubernetes clusters (MKS) on your OpenStack infrastructure, you need to prepare it by uploading the required base images and tagging them so the platform can discover them automatically.

Prerequisites

Before you begin, make sure you have:

  • OpenStack CLI (python-openstackclient) installed on your workstation
  • Valid credentials: Your OpenStack clouds.yaml or RC file sourced in your shell
  • Sufficient permissions: Ability to upload images to the Glance image service (typically the admin or member role on the target project)

Web UI Limitations

Neither Horizon nor Skyline support managing Glance image tags through their web interfaces. You must use the OpenStack CLI to complete the setup described in this guide.

Supported Versions

The platform identifies which images to use for cluster provisioning based on Glance image tags. Each Kubernetes version requires a specific tag applied to its corresponding image.

Kubernetes Version Required Image Tag Image Download
1.33.1 ec-kube-v1.33.1 Download
1.32.7 ec-kube-v1.32.7 Download

Tags are mandatory

If the images are not tagged correctly, the platform will not be able to find them and cluster provisioning will fail.

Setup Instructions

Select the Kubernetes version you want to install to get the full set of commands ready to copy and paste.

1. Download the image

curl -LO https://images.edgecontinuum.com/ubuntu-2404-kube-v1.33.1

2. Upload the image to Glance

openstack image create \
  --disk-format qcow2 \
  --container-format bare \
  --file ubuntu-2404-kube-v1.33.1 \
  "ec-kube-v1.33.1"

3. Tag the image

openstack image set --tag ec-kube-v1.33.1 "ec-kube-v1.33.1"

4. Verify

openstack image list --tag ec-kube-v1.33.1

Expected output:

+--------------------------------------+------------------+--------+
| ID                                   | Name             | Status |
+--------------------------------------+------------------+--------+
| <image-id>                           | ec-kube-v1.33.1  | active |
+--------------------------------------+------------------+--------+

1. Download the image

curl -LO https://images.edgecontinuum.com/ubuntu-2204-kube-v1.32.7

2. Upload the image to Glance

openstack image create \
  --disk-format qcow2 \
  --container-format bare \
  --file ubuntu-2204-kube-v1.32.7 \
  "ec-kube-v1.32.7"

3. Tag the image

openstack image set --tag ec-kube-v1.32.7 "ec-kube-v1.32.7"

4. Verify

openstack image list --tag ec-kube-v1.32.7

Expected output:

+--------------------------------------+------------------+--------+
| ID                                   | Name             | Status |
+--------------------------------------+------------------+--------+
| <image-id>                           | ec-kube-v1.32.7  | active |
+--------------------------------------+------------------+--------+

Summary

flowchart LR
    A["Download\nQCOW2 image"] --> B["Upload to\nGlance"]
    B --> C["Tag with\nrequired tag"]
    C --> D["Verify"]
    D --> E["Ready for\nMKS ✓"]

Once your images are uploaded and correctly tagged, your OpenStack infrastructure is ready for the platform to provision Managed Kubernetes clusters.