Version: Next 🚧

Creating a K3s Kubernetes Cluster

This how-to was written using the following versions:

Get K3s Kubernetes Cluster

Follow the instructions to install K3s on your system.

The K3s versions used in this how-to are the ones mentioned just above, with all the options set by default.

Export the k3s cluster configration first:

export KUBECONFIG=/etc/rancher/k3s/k3s.yaml

Follow "magic" DNS setup to install Epinio in your test environment.

<IP> can be found by running:

$ kubectl get svc -n kube-system traefik -o jsonpath="{.status.loadBalancer.ingress[0]}"

In case of trouble with DNS resolution, for example if you have something like this in your logs:

dial tcp: lookup epinio-registry.192.168.1.10.omg.howdoi.website on 10.43.0.10:53: no such host

You can try to install K3s with one known-to-work DNS server:

curl -sfL https://get.k3s.io | K3S_RESOLV_CONF=/etc/my-good-resolv.conf sh -

With /etc/my-good-resolv.conf containing:

nameserver 1.1.1.1

This kind of issue could happen for example when you have multiple DNS servers and some of them are not able to resolve some domain names.

In case of trouble with Epinio's Traefik component or Ingress controllers, the Traefik section in the Advanced Topics document shall be your friend.