microk8s-homelab

Expose your MicroK8s homelab to the Internet

Architecture

Developing

Fork and clone this repository, then navigate to the project root and follow the instructions below.

Install pre-commit hook (optional)

The pre-commit hook runs formatting and sanity checks such as tofu fmt to reduce the chance of accidentally submitting badly formatted code that would fail CI.

ln -s ../../hooks/pre-commit ./.git/hooks/pre-commit

Prerequisites

AWS

If deploying the resources to AWS, you'll need to install and set up AWS CLI v2 with a valid access key and secret key corresponding to an IAM administrator account.

OpenTofu

Install the latest version of OpenTofu. The version used is 1.6.1 at the time of writing (2024-02-10).

You'll also need an SSH key pair for remoting into your instance - generate this with ssh-keygen if you haven't already.

N.B. It is strongly advised to use a dedicated microk8s-homelab SSH key pair for remoting into your instance and reverse tunneling instead of your default SSH key pair (if exists).

Deploy

OpenTofu

export CLOUD_PROVIDER="aws"
export TF_VAR_email="webmaster@example.com" # replace me!
tofu -chdir="opentofu/${CLOUD_PROVIDER}/" init
tofu -chdir="opentofu/${CLOUD_PROVIDER}/" plan
tofu -chdir="opentofu/${CLOUD_PROVIDER}/" apply

The following OpenTofu variables are supported for AWS.

License

MIT