Skip to content
Products
Platform
Developer Tools
Portal

Getting started

Last updated on

The following pages show you how to create a single-node Talos Kubernetes cluster using STACKIT Edge Cloud (STEC).

You can manage STEC through its user interface (UI), its command-line interface (CLI), or its RESTful application programming interface (API). Where applicable, this guide provides instructions for each method.

Once the instance is created, you can manage all the objects using the Kubernetes API endpoint and a web UI provided by the service.

Before you continue reading the documentation on how to use the service, please review the key Custom Resource Definitions (CRDs) of STEC to better understand how the service works:

  • EdgeCluster: The central resource used to manage a Talos Kubernetes cluster and its node members.
  • EdgeImage: The configuration data of a STEC boot image used to obtain a boot medium.
  • EdgeMachine: The intermediary resource between EdgeCluster and EdgeHost. Every host in a cluster has an associated EdgeMachine resource.
  • EdgeHost: The resource created when a host machine is booted from an EdgeImage and successfully registers with the STEC instance.

When an EdgeImage is built, the Talos extension Edgehostlet is automatically added. The extension is built and maintained by the STACKIT Edge Cloud team to provide all necessary features.

When you create a new EdgeImage or EdgeCluster, you must select the Talos version to be used. The version format used by the service differs from official Talos versions. STEC versions follow the format vx.y.z-stackit.vX.Y.Z, where vx.y.z is the Talos version and vX.Y.Z is the version of the Edgehostlet extension. Be aware that different versions of Talos are available, each matched with a specific version of the Edgehostlet extension.

You can list the available versions by running the following command:

Terminal window
# get available extensions
> INSTANCE_REGION="eu01"
> curl https://image-factory.edge.$INSTANCE_REGION.stackit.cloud/versions
[
 "v1.10.5-stackit.v0.20.0",
 "v1.10.5-stackit.v0.21.0",
 "..."
]

Now you can start creating your first instance: Ordering an instance.