Skip to content

About

Tabsdata embedded container-less single node Kubernetes

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Tabsdata Tabsdata

KMinus

A lightweight, local Kubernetes environment that runs entirely on a single machine, without containers or virtual machines. The kminus stack bundles a real Kubernetes control plane (API server, etcd and controller manager) with a virtual kubelet that runs pods as native processes, which gives a fast and minimal Kubernetes for development and testing.

It holds the orchestration components of tabsdata: native-process pods (km). Every local tabsdata instance runs on it.

Components

Component Language What it does
control‑plane Go Starts a local Kubernetes control plane
Runs kube‑apiserver, etcd, kube‑controller‑manager
Writes the kubeconfigs of the administrator and the components
virtual‑kubelet Go Registers as a node in the cluster
Runs the pods as native processes on the host, not in containers
pod‑runner Rust Manages the lifecycle of each pod as native host processes
kminus Rust The distribution binary, km
Starts the other components as child processes
Orchestrates them

Running kminus

Build kminus first, as Developing KMinus describes. The binaries land in target/dist.

Create an instance in a folder that doesn't exist yet.

macOS and Linux:

./target/dist/km create --workdir ~/km-demo

Windows:

.\target\dist\km.exe create --workdir $HOME\km-demo

Start it. The command stays in the foreground until you stop the instance, so leave this terminal open and use another one for the next steps.

macOS and Linux:

./target/dist/km start --workdir ~/km-demo

Windows:

.\target\dist\km.exe start --workdir $HOME\km-demo

Point kubectl at the instance, and apply a manifest.

macOS and Linux:

export KUBECONFIG=~/km-demo/config/kubeconfig.yaml
./target/dist/kubectl apply -f examples/deployment.yaml

Windows:

$env:KUBECONFIG = "$HOME\km-demo\config\kubeconfig.yaml"
.\target\dist\kubectl.exe apply -f examples\deployment.yaml

Check the instance, and stop it when you're done.

macOS and Linux:

./target/dist/km status --workdir ~/km-demo
./target/dist/km stop --workdir ~/km-demo

Windows:

.\target\dist\km.exe status --workdir $HOME\km-demo
.\target\dist\km.exe stop --workdir $HOME\km-demo

The examples explain the conventions a pod must follow to run on kminus.

Building kminus from Source

The kminus stack is meant to be built and used together with tabsdata, checked out side by side. Its Developing Tabsdata guide covers the software to install, the clone, the build environment and the toolchain.

Developing KMinus adds what is specific to this repository: its layout, its tasks, its build profiles and its tests.

Design Documents

License

Licensed under the Apache License, Version 2.0.

About

Tabsdata embedded container-less single node Kubernetes

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages