Installation instructions

[pedroleaoc (Pedro Leão da Cruz)]

Prerequisites

• Juju CLI - Necessary for all deployments
• MicroK8s - Necessary for local deployments

Windows and MacOS

The commands below are for an Ubuntu 20.04 machine. You can find instructions for Windows and MacOS in the next session.

References and other operating systems:

Installing Juju

Project’s page

Windows

Visit the project’s downloads page and select the signed installer for the Juju version you wish to install.

MacOS

The Juju client is available on Homebrew and can be installed as follows:

brew install juju

Installing MicroK8s

Project’s page

Windows

1. Download the MicroK8s Installer Download the latest installer here

2. Run the installer

The installer checks if Hyper-V is available and switched on. If you don’t have Hyper-v (e.g. on Windows 10 Home edition) it is possible to use VirtualBox as an alternative.

3. Configure MicroK8s

You can now configure MicroK8s - the minimum recommendations are already provided. For information on changing the ‘Snap Track’, see this page.

MacOS

The installer for MicroK8s uses HomeBrew. If you don’t have the brew command you can install it from the Homebrew website.

1. Download the MicroK8s installer

brew install ubuntu/microk8s/microk8s

2. Run the installer

microk8s install

Configuring MicroK8s (all systems)

After installing MicroK8s, you can configure it by running

microk8s enable dns storage ingress 
microk8s status --wait-ready

Wait for the services to be enabled

Make sure that dns, ingress and storage are listed as enabled. This can take a couple of minutes.