K2s is a Kubernetes distribution which packages different open-source components into one small and easy to use solution focusing on running mixed Windows-based & Linux-based workloads in Kubernetes.
This solution is installable on Windows hosts.
Read the K2s Documentation.
The problems that K2s solves are the following:
- It provides the option to construct a K8s cluster by reusing the Windows host as a node. This eliminates the need for an extra Windows license in the case of a mixed Windows & Linux cluster.
- Offline support is available for all use cases, eliminating the requirement for an internet connection.
- It offers an easy path for migrating bare metal Windows applications to K8s workloads.
- It maintains a low footprint by utilizing a single virtual machine for Linux workloads. (Hyper-V or WSL).
- It is built on 100% open source technology, requiring no additional licenses.
The name K2s comes from the fact that we start with the default setting of 2 K8s nodes (Windows & Linux) and it relates to K8s with the intention to solve the problems mentioned above.
See Features for a full list of features.
- Get K2s
- Verify that the Prerequisites are fulfilled
- Run as administrator in the installation/repository folder
k2s.exe install
After installation, you can utilize one of the shortcuts to interact with your newly created cluster:
k - shows the commands available for interacting with the K8s cluster
ks - get the state of the cluster
kgn - show the nodes of the cluster
kgp - show all the pods running in the cluster
...
Beside the raw K8s cluster we are also providing a rich set of addons, which are bringing additional specific functionality to your cluster. Enabling such an addon is a straightforward process:
k2s addons ls - lists all the available addons
k2s addons enable ingress-nginx - enables the ingress nginx ingress controller
...
Disabling the same addon:
k2s addons disable ingress-nginx - disables the ingress nginx ingress controller
...
Uninstalling the cluster removes not only the cluster itself but also all the workloads within the cluster:
<installation folder>.\k2s uninstall
In case that multiple systems need to be provisioned with Kubernetes or you want to reduce the install time dramatically, it is better to create one K2s offline package (contains all downloaded artifacts) before starting the install command. Setting up the Kubernetes cluster with the offline package takes only 2-3 minutes and needs no internet connection. Checkout how to create such offline packages: Create Offline Package.
See also Windows-based Images.
- Get K2s
- Install K2s
- Start K2s (optional, K8s cluster starts automatically after installation)
- Check Cluster Status
- Stop K2s
- Uninstall K2s
- Add a registry
- Build a container image
- Shortcuts for interacting with cluster
- Upgrade K2s
- Create Offline Package
K2s provides a rich set of addons which are containing specific functionality, checkout the k2s addons command for all options.
These addons can be used for testing and rapid prototyping purposes, as well in selected product scenarios.
