maas-baremetal-k8s-tutorial/README.md

# Bare metal Kubernetes with MAAS, LXD, and Juju

## Intro

This is a series of commands and configuration files that will guide you to build your own emulated bare metal k8s cluster on a single machine, using https://maas.io.

It is designed to be used in conjunction with an explanatory video tutorial: https://www.youtube.com/watch?v=sLADei_c9Qg

## How to use

Read maas-setup.sh. The script is not fully automated and requires manual intervention at times. Read the comments to understand the process.

## Requirements

You need a reasonably powerful **bare metal** machine, 4 or more cores with 32 GB of RAM and 500GB of free disk space. Assumes a fresh install of Ubuntu server (20.04 or higher) on the machine. 

You will need to install the command line configuration tool for Kubernetes [`kubectl`](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/)

The reason you need a bare metal machine is because nesting multiple layers of VMs will not work and/or have performance problems.

Note: this tutorial has not been tested on versions prior to 20.04.
Update README.md 2021-11-21 13:17:05 +00:00			`# Bare metal Kubernetes with MAAS, LXD, and Juju`

			`## Intro`

Update README.md 2021-12-03 18:01:27 +00:00			`This is a series of commands and configuration files that will guide you to build your own emulated bare metal k8s cluster on a single machine, using https://maas.io.`
Update README.md 2021-11-21 13:17:05 +00:00
Update README.md 2021-12-03 18:00:45 +00:00			`It is designed to be used in conjunction with an explanatory video tutorial: https://www.youtube.com/watch?v=sLADei_c9Qg`
Update README.md 2021-11-21 13:17:05 +00:00
			`## How to use`

			`Read maas-setup.sh. The script is not fully automated and requires manual intervention at times. Read the comments to understand the process.`

			`## Requirements`

updating regarding ubuntu version + bare metal req 2022-02-11 18:46:54 +00:00			`You need a reasonably powerful bare metal machine, 4 or more cores with 32 GB of RAM and 500GB of free disk space. Assumes a fresh install of Ubuntu server (20.04 or higher) on the machine.`

Update README.md 2022-03-15 14:23:25 +00:00			You will need to install the command line configuration tool for Kubernetes [`kubectl`](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/)
Update README.md I had to do this step to be able to run the `kubectl` command, I thought I would flag it. 2022-03-15 13:01:48 +00:00
updating regarding ubuntu version + bare metal req 2022-02-11 18:46:54 +00:00			`The reason you need a bare metal machine is because nesting multiple layers of VMs will not work and/or have performance problems.`

			`Note: this tutorial has not been tested on versions prior to 20.04.`