Skip to content

Kubernetes Service

Introduction

Kubernetes is a container orchestration platform that automates the deployment, scaling, and management of containerized applications. Switch Cloud Kubernetes is powered by Kubermatic and leverages Switch Cloud Compute as its underlying infrastructure.

Important

The Portal provides a limited set of actions for managing the Kubernetes service. To create, update, or delete clusters, or to perform other advanced operations, you must use the Kubermatic Dashboard.

Provision and Use the Kubernetes Service

When you activate the Kubernetes service for your project, the following tasks are performed:

  1. Link to Compute:
    • If the Compute service is already activated, the Kubernetes service links to it automatically.
    • If not, the Compute service gets activated and then linked.
  2. Credentials and Preset Generation:
    • A Kubermatic project is created, along with credentials and a preset, that connects it to the corresponding OpenStack project.
  3. Redirection to Kubernetes Main Page:

View Kubernetes Project Information

On the Kubernetes service main page, you will see:

  • Project Name.
  • Status (Active, Creating, Deleting, Failed).
  • Updated At and Created At timestamps.
  • UID (the unique identifier for your Kubernetes instance).
  • Clusters table (read-only from the Portal).
  • Members table, with an Add member button.

A link icon appears next to the Kubernetes page title, indicating that the Kubernetes service is linked to a Compute service. Hovering over it reveals the preset name used for the connection.

Note

All cluster-related actions (creation, scaling, deletion) must be performed in the Kubermatic Dashboard.

The link between Compute and Kubernetes is primarily based on a Provider Preset that contains all the necessary authentication details for your OpenStack project. When you create a cluster in the Kubermatic Dashboard, selecting the provider preset automatically disables most provider-related fields, reducing the need for manual configuration.

Manage Members

From the Kubernetes service page, you can add or remove members who will have access to the Kubermatic project:

Add a Member

  1. Click Add member in the Members section.
  2. Choose a user from the list of project or organisation members.
  3. Assign a Kubermatic role (Owner, Editor, Viewer).
  4. Click Add member to confirm.
  5. If the user does not already have a Kubermatic account, one is created automatically.

Remove a Member

  1. Locate the user in the Members table.
  2. Click Remove next to the user’s name.
  3. Confirm the removal when prompted.

Edit the Project Name

To rename your Kubernetes project:

  1. Click Edit in the top-right corner of the Kubernetes service page.
  2. Enter the new project name.
  3. Click Save to confirm.

Delete the Kubernetes Project

You can delete the Kubernetes project only if no clusters are active. If any clusters remain, you must first delete them via the Kubermatic Dashboard. Once all clusters are removed:

  1. Click Delete in the top-right corner of the Kubernetes service page.
  2. Enter the project name to confirm deletion.
  3. Click Delete Project and Associated Resources.

Warning

Deleting the project will unlink the Kubernetes service from the Compute service and irreversibly delete all associated resources, including presets and credentials.
If the Kubernetes service is linked to a Compute service, that Compute service cannot be deleted until the Kubernetes service (and all clusters) are removed.