Setting Up Your Development Machine

Cluster Access
It's not ideal having to ssh into your server every time you want to do something. To access this cluster remotely, we need to do two things:
1.Copy the cluster access configuration that k3s generated to your development machine.
2.Install the kubernetes control tool (kubectl)
Install Kubectl
Depending on if your development machine is Linux, Mac or Windows, there are instructions to install it here.
Copy your cluster config
From the doc:
Copy /etc/rancher/k3s/k3s.yaml on your machine located outside the cluster as ~/.kube/config. Then replace “localhost” with the IP or name of your K3s server. kubectl can now manage your K3s cluster.
Now let's run that same command we did before to see if the node is working:
1
[email protected]:~ $ kubectl get nodes
2
NAME   STATUS   ROLES                  AGE   VERSION
3
cpi6   Ready    control-plane,master   51s   v1.21.3+k3s1
Copied!
Winner! So much nicer than sshing to the machine every time
Starting Your Infrastructure as Code Directory
❗Concept: Kubernetes Objects What is really awesome about Kubernetes is that you can code up a desired state that you want it to do, then "apply" those configuration files (call Kubernetes Objects) and it will try to do set up that state (called ". As your cluster grows over time, you want to keep your configuration in static files so you can refer back, make changes as needed, and use them as references for other things you want to deploy.
Since the configuration files that we ask Kubernetes to "apply" are just yaml files, you can organize them however you like. Personally, I like to group them by the purpose for each deployment. It looks like this (I didn't include everything to not clutter everything)
1
todo.txt
2
README.md
3
shared/
4
smarthome/
5
├─ home-assistant/
6
├─ (other stuff)/
7
rss-reader/
8
media/
9
├─ jellyfin/
10
├─ (other stuff)/
11
network/
12
├─ healthcheck/
13
├─ adguard/
Copied!
Each folder contains a few Kubernetes Object files. Let's start simple and create a new directory somewhere on your machine:
1
$ mkdir homelab-code
2
$ cd homelab-code
Copied!
Let's also create a git repo for that dir:
1
$ git init .
Copied!
Let's get rolling
References
Official k3s doc on this process​
​Kubernetes Objects​

Foundations - Previous

Setting up your Master Node

Next - Foundations

Adding Internet Health Monitor

Last modified 2mo ago

Copy link

Contents

Cluster Access

Starting Your Infrastructure as Code Directory