WSL2 (Windows Subsystem for Linux version 2) - Installation instructions

[paulofrazao]

Prerequisites

Windows 10 2004 or higher (including version 21H2 and 21H1
WSL2 - Click here for instructions
Brew for Linux - Click here for instructions
Docker - Click here for WSL2 instructions without requiring Docker Desktop

Start by cloning the repository locally:

git clone https://github.com/stefanprodan/flux-local-dev.git
cd flux-local-dev

Install Kubernetes kind, kubectl, flux and other CLI tools with Homebrew:

make tools

The complete list of tools can be found in the Brewfile.

Bootstrap

Start the dev environment with:

make up

Access Flux UI

In order to access the UI from your Windows workstation where WSL2 is running, you need to modify %systemroot%\System32\drivers\etc\hosts and add 3 domain name entries and the IP address of the Ubuntu server in WSL2.

ip a

In the example below, the required IP would be the inet address under eth0

Add the following domains to %systemroot%\System32\drivers\etc\hosts

REMEMBER TO REPLACE 172.19.4.195 IN THE EXAMPLE BELOW WITH THE IP ADDRESS OF YOUR UBUNTU SERVER!!!

172.19.4.195 podinfo.flux.local
172.19.4.195 grafana.flux.local
172.19.4.195 ui.flux.local

Verify that the NGINX ingress self-signed TLS works:

make check

Access the Flux UI and Grafana using the username admin and password flux:

• http://ui.flux.local/applications
• http://grafana.flux.local/d/flux-control-plane
• http://grafana.flux.local/d/flux-cluster

Access the demo application on http://podinfo.flux.local.

Teardown

Delete the registry and the Kubernetes cluster with:

make down