Skip to content

Single node cluster

This example shows how to setup a single node Kubernetes cluster using Kubitect.

Architecture of a single node cluster

Note

In this example we skip the explanation of some common configurations (hosts, network, node template, ...), as they are already explained in the Getting started (step-by-step) guide.

Step 1: Create the configuration🔗︎

If you want to initialize a cluster with only one node, specify a single master node in the cluster configuration file:

single-node.yaml
cluster:
  ...
  nodes:
    master:
      instances:
        - id: 1
          ip: 192.168.113.10 # (1)!
  1. Static IP address of the node. If the ip property is omitted, the DHCP lease is requested when the cluster is created.
Final cluster configuration
single-node.yaml
hosts:
  - name: localhost
    connection:
      type: local

cluster:
  name: local-k8s-cluster
  network:
    mode: nat
    cidr: 192.168.113.0/24
  nodeTemplate:
    user: k8s
    updateOnBoot: true
    ssh:
      addToKnownHosts: true
    os:
      distro: ubuntu
  nodes:
    master:
      default:
        ram: 4
        cpu: 2
        mainDiskSize: 32
      instances:
        - id: 1
          ip: 192.168.113.10

kubernetes:
  version: v1.23.7
  networkPlugin: calico
  dnsMode: coredns
  kubespray:
    version: v2.19.0

Step 2: Applying the configuration🔗︎

Apply the cluster: 

kubitect apply --config single-node.yaml

Your master node now also becomes a worker node.