Kubernetes template

This template can be used to spin up a single node Kubernetes cluster.

Source: https://github.com/instruqt/packer-k3s

What's included

  • Kubernetes based on K3S (see versions below)

  • Helm 3

  • Kubernetes dashboard

  • Systemd service for kubectl proxy

  • Bash script to wait for Kubernetes dashboard to start and print the dashboard token (/usr/bin/start.sh)

  • Kubectl completion (see section on how to enable kubectl autocompletion)

Current active images

  • instruqt/k3s-v1-20-4

  • instruqt/k3s-v1-19-8

  • instruqt/k3s-v1-18-16

  • instruqt/k3s-v1-18-8

  • instruqt/k3s-v1-18-6

  • instruqt/k3s-v1-18-4

  • instruqt/k3s-v1-18-3

  • instruqt/k3s-v1-18-2

  • instruqt/k3s-v1-17-11

  • instruqt/k3s-v1-17-9

  • instruqt/k3s-v1-17-7

  • instruqt/k3s-v1-17-6

  • instruqt/k3s-v1-17-5

  • instruqt/k3s-v1-17-4

Usage on Instruqt

There is no need to build this packer image yourself. It has already been built. We advise you to use machine type n1-standard-2 or higher to ensure stability.

How to configure this image in your config.yml

Use the following config in your Instruqt config.yml to use this image:

version: "2"
- name: kubernetes
image: instruqt/k3s-v1-20-4
shell: /usr/bin/start.sh
machine_type: n1-standard-2

Setting the shell to /usr/bin/start.sh will wait for the Kubernetes dashboard to start and prints our the dashboard token in the terminal

Enabling kubectl autocompletion

To enable kubectl autocompletion, add the following lines to the setup script of your first challenge:

until [ -f /opt/instruqt/bootstrap/host-bootstrap-completed ]
sleep 1
echo "source /usr/share/bash-completion/bash_completion" >> /root/.bashrc
echo "complete -F __start_kubectl k" >> /root/.bashrc