Deckhouse Platform in kind

kind is a tool for running local Kubernetes clusters using container “nodes” and was primarily designed for testing Kubernetes itself, but may be used for local development or CI.

Installing Deckhouse on kind, will allow you to get a Kubernetes cluster with Deckhouse installed in less than 10 minutes. It will allow you to get acquainted with Deckhouse main features quickly.

Please note that some features, such as node management and control plane management will not work.

This guide covers installing Deckhouse in a minimal configuration, with Grafana based monitoring enabled. To simplify, the nip.io service is used for working with DNS.

Installation process

To install, you will need a personal computer that meets the following requirements:

  • Operating system: macOS, Windows or Linux.
  • At least 4GB of RAM.
  • Installed container runtime (docker, containerd) and docker client.
  • HTTPS access to the registry.deckhouse.io container image registry.

A Kubernetes cluster will be deployed on this computer, and Deckhouse will be installed into a cluster.

You may choose the following variants of installation:

  • Go through the steps of the guide by yourself.
  • Use the installation script for Debian like Linux distributions or macOS:
    • Run the following command for installing Deckhouse Community Edition:
      bash -c "$(curl -Ls https://raw.githubusercontent.com/deckhouse/deckhouse/main/tools/kind-d8.sh)"
      
      bash -c "$(curl -Ls https://raw.githubusercontent.com/deckhouse/deckhouse/main/tools/kind-d8.sh)"
    • Or run the following command for installing Deckhouse Enterprise Edition by providing a license key:
      bash -c "$(curl -Ls https://raw.githubusercontent.com/deckhouse/deckhouse/main/tools/kind-d8.sh)" -- --key <LICENSE_KEY>
      
      bash -c "$(curl -Ls https://raw.githubusercontent.com/deckhouse/deckhouse/main/tools/kind-d8.sh)" -- --key <LICENSE_KEY>
    • Go to the final step of the guide.

After installation is complete, you will be able to enable all the modules of interest on your own. Please, refer to the documentation to learn more or reach out to the Deckhouse community.