spectrum ipv6 vlan migration

k3s/README.md

@@ -9,6 +9,8 @@
   - [Storage](#storage)
   - [Coredns](#coredns)
   - [Metal LB](#metal-lb)
+    - [VLAN Setup](#vlan-setup)
+    - [Installation](#installation)
   - [External DNS](#external-dns)
     - [Credentials](#credentials)
     - [Annotation](#annotation)
@@ -131,6 +133,25 @@ kubectl run -it --rm \
 
 ## Metal LB
 
+### VLAN Setup
+
+Before working with Metallb you'll need at least one available VLAN. On Unifi equipment
+this is accomplished by creating a new network. Don't assign it to anything.
+
+On the linux machine you can use nmcli or cockpit to configure a new VLAN network interface.
+With cockpit:
+
+1. Add a new VLAN network
+2. The parent should be the physical adapter connected to your switch
+3. Set the VLAN ID to the VLAN number of your created unifi network
+4. Click create
+5. Click into the new network
+6. Turn off IPv4 and IPv6 DNS (it will overload the resolv.conf hosts limit)
+7. Turn on the network interface
+8. Attempt to ping the acquired address(es)
+
+### Installation
+
 We'll be swapping K3S's default load balancer with Metal LB for more flexibility. ServiceLB was
 struggling to allocate IP addresses for load balanced services. MetallLB does make things a little
 more complicated- you'll need special annotations (see below) but it's otherwise a well-tested,