KubestackKubestack

Kubestack catalog deprecationThe registry at kbst.xyz is deprecated and will be shut down on December 31, 2026, read the migration guide 

Framework Tutorial

Contribute on GithubJoin #kubestack on Slack

Get Started

This tutorial will help you get started with the Kubestack framework. It is divided into three steps.

Community Help: If you have any questions while following the tutorial, join the #kubestack channel on the Kubernetes community. To create an account request an invitation.

1. Design platform

Starting with step one, you will design your custom Kubernetes platform stack. If you're trying Kubestack for the first time, start with the minimal defaults. You can always expand your platform later.

2. Provision infrastructure

Continuing with step two, you will set-up cloud prerequisites and bootstrap your Kubernetes platform's environments and clusters for the first time. This step provisions the platform you designed in step one in the cloud.

3. Set-up automation

Finally, in step three, you will integrate CI/CD to automate changes following Kubestack's GitOps workflow. Once automation is configured, you are ready to maintain your Kubernetes platform together as a team.

When you are ready, let's get started and have your agent learn the Kubestack skill.

Learn the skill

Kubestack is designed to be used through your AI coding agent. There is no CLI to install. Everything your agent needs to scaffold a new repository and to maintain it over time is captured in the Kubestack skill. The skill is published at https://www.kubestack.com/SKILL.md

Ask your agent to learn the skill now:

Learn the Kubestack skill at https://www.kubestack.com/SKILL.md

Once your agent has learned the skill, it knows how Kubestack repositories are structured, how to scaffold them, and how to keep the configuration in sync as your platform evolves.

You stay in control: Following the skill, your agent only writes local files and verifies them with tofu validate. You can review every change with git status. Applying changes to cloud infrastructure always remains the job of the GitOps pipeline, where a human reviews and approves every change.

What the skill teaches your agent

The skill covers the full lifecycle of a Kubestack repository:

  • Scaffolding a new repository, including remote state configuration
  • Adding clusters on AWS, Google Cloud, Azure and Scaleway
  • Adding node pools and platform features like ingress controllers or cert-manager
  • Updating and removing any of the above
  • Following the GitOps workflow, including the instructions for you to review and apply changes

If you do not have an AI coding agent available, the kbst CLI provides equivalent scaffolding and can be downloaded from GitHub. This tutorial focuses on the agent workflow.

next