CSTF/wild-cloud
1
1
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects 1 Releases 1 Wiki Activity

Add cluster node setup documentation and scripts for K3s and Talos

Browse Source
This commit is contained in:
Paul Payne
2025-06-20 16:39:22 -07:00
parent e2485627b1
commit 3dbd037386
8 changed files with 122 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
docs/SETUP.md
View File

@@ -1,27 +1,25 @@
# Setting Up Your Wild Cloud
## Set up your cloud bootstrapper
## Set up your personal cloud operations directory
See [Dnsmasq Setup](./guides/dnsmasq-setup.md).
- Create a directory somewhere. We recommend you use an Ubuntu machine.
- Inside it, run `wild-init`. This will scaffold your cloud directory.
- In your cloud directory, update `.wildcloud/config.yaml`. Use the same values in this dir in a `.env`
## Set up your Cloud Central
See [Central Setup](../central-setup/README.md).
## Set up Control Nodes
### 2. Install K3s (Lightweight Kubernetes)
K3s provides a fully-compliant Kubernetes distribution in a small footprint:
```bash
# Install K3s without the default load balancer (we'll use MetalLB)
curl -sfL https://get.k3s.io | sh -s - --write-kubeconfig-mode=644 --disable servicelb --disable metallb
# Set up kubectl configuration
mkdir -p ~/.kube
sudo cat /etc/rancher/k3s/k3s.yaml > ~/.kube/config
chmod 600 ~/.kube/config
```
See [Cluster Node Setup](../cluster-node-setup/README.md).
## Install Infrastructure Components
> Currently, these are set up to run from this directory. This will be moved to (1) a `bin/wild-generate-infrastructure-setup` script to copy them all to your personal cloud dir, (2) `wild-cli` (to do the same), or (3) `wild-central`, once I get my mind made up.
One command sets up your entire cloud infrastructure:
```bash
@@ -38,19 +36,6 @@ This installs and configures:
- **ExternalDNS**: Updates DNS records automatically
- **Kubernetes Dashboard**: Web UI for managing your cluster
## Set up worker nodes
For larger workloads or high availability, you can add more nodes:
```bash
# On your master node, get the node token
NODE_TOKEN=`sudo cat /var/lib/rancher/k3s/server/node-token`
MASTER_IP=192.168.8.222
# On each new node, join the cluster
curl -sfL https://get.k3s.io | K3S_URL=https://$MASTER_IP:6443 K3S_TOKEN=$NODE_TOKEN sh -
```
## Next Steps
Now that your infrastructure is set up, you can:

32
docs/guides/talos-setup.md
View File

@@ -1,32 +0,0 @@
# Talos
This is an alternate setup to using ks that uses talos and bare kubernetes. IN PROGRESS.
From https://www.talos.dev/v1.10/introduction/getting-started/
```bash
# Install kubectl
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
echo "$(cat kubectl.sha256) kubectl" | sha256sum --check
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
# Install talosctl
curl -sL https://talos.dev/install | sh
# Generate cluster config files (and pki and tokens)
talosctl gen config test-cluster https://192.168.8.238:6443
talosctl -n 192.168.8.238 get disks --insecure
# Update disk in controlplane.yml
# Apply control plane config
talosctl apply-config --insecure --nodes 192.168.8.238 --file controlplane.yaml
# Bootstrap cluster on control plan
talosctl bootstrap --nodes 192.168.8.238 --endpoints 192.168.8.238 --talosconfig=./talosconfig
# Merge into kubeconfig
talosctl kubeconfig --nodes 192.168.8.238 --endpoints 192.168.8.238 --talosconfig=./talosconfig
```