https://github.com/kabisa/k8s-workshop-in-a-box

Tool for "one click" Kubernetes workshop setups
https://github.com/kabisa/k8s-workshop-in-a-box

Last synced: 8 days ago
JSON representation

Tool for "one click" Kubernetes workshop setups

• Host: GitHub
• URL: https://github.com/kabisa/k8s-workshop-in-a-box
• Owner: kabisa
• Created: 2020-03-27T14:43:23.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-04-21T13:43:10.000Z (over 4 years ago)
• Last Synced: 2024-08-02T15:10:28.052Z (3 months ago)
• Language: Shell
• Size: 1.11 MB
• Stars: 39
• Watchers: 4
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# K8s workshop in a box

This is a setup for running Kubernetes workshops using 'real' clusters,

without attendees having to install anything on their personal computers.

## How does it work?

This setup uses [Kind](https://kind.sigs.k8s.io/) to run a number of clusters isolated in Docker containers, on one big (cloud) server. Every participant of the workshop gets a 3 node Kubernetes cluster (one master two workers), running in 3 Docker containers per cluster.

The clusters are fully isolated, with their own internal IP space.

## Requirements

* A beefy (cloud) server. 

  * I used an AWS `m5.8xlarge` instance for a 15 person workshop, we had quite a bit of capacity left. Initialising the clusters is most resource intensive. Besides that it depends mostly on the workloads you're running during the workshop.

  * Running a three hour workshop costs about ~ 5$ this way. That's even cheaper than a pizza 🍕!

* Ubuntu 18.04 host OS. It may work with other Linux flavours, but the setup was only tested with Ubuntu 18.04 so far.

* SSH port open on the host node.

## Setup

1. Provision a host node, as described in Requirements above.

2. SSH into the node, clone this repository (`git clone https://github.com/kabisa/k8s-workshop-in-a-box.git`).

3. Run the `setup.sh` script with root privileges.

4. Create the desired number of clusters using `./create-clusters.sh `. Best run this from screen/tmux as it will take a while (few minutes per cluster).

5. Done! 🙌

## Accessing the clusters

After the clusters are created, participants can claim their own cluster via SSH:

```

ssh icanhazcluster@

```

An SSH command to connect to your personal cluster will be printed.

Here it is in action:

![demo](./demo.gif)

## Caveats

* This is horribly insecure, using unauthenticated SSH (for ease of use). It's probably best to only allow SSH access from the IP address of your workshop venue.

* This was tested with up to 15 clusters.

* Use at your own risk :-)