From 49637b9825faebae51431ddf37bdf9748bff14ec Mon Sep 17 00:00:00 2001 From: greysoh Date: Fri, 19 Jul 2024 10:45:42 -0400 Subject: [PATCH] chore: Update README. --- README.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 18131d1..94069ff 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # KittehCluster -This is my (work in progress, deployed but nothing production running on it *yet*) Kubernetes clustered computing setup, based on Proxmox VE and Ubuntu Server. - +This is my (work in progress, deployed but nothing production running on it *yet*) Kubernetes clustered computing setup, based on Proxmox VE and Ubuntu Server. + Currently, I *really* cannot recommend that you use this setup in production yet. I have to delete and recreate my VMs multiple times a day, until I fix everything. ## Prerequisites - A POSIX-compliant computer (preferably Unix of some sort, like macOS/Linux/*BSD, but Git Bash or Cygwin would probably work) with Python and Pyyaml @@ -20,17 +20,19 @@ Currently, I *really* cannot recommend that you use this setup in production yet ### Kubernetes setup 1. SSH into any of the nodes. (i.e `ssh clusteradm@kitteh-node-2-k3s-server`) 2. As root, grab `/etc/rancher/k3s/k3s.yaml`, and copy it to wherever you store your k3s configurations (on macOS, this is `~/.kube/config`) +3. Go into the `kubernetes` directory, and copy `example-secrets` to `secrets` and modify these to be your credentials. +4. Run `./kubesync.py`. If you recieve MetalLB errors while this happens, `rm -rf meta`, and try again. It should work on the second attempt. If not, report this issue. ## Updating Run `apt update` and `apt upgrade -y` for the base system. TODO for Kubernetes. ## Customization ### Adding nodes In `serverinfra/infrastructure.ini`, copy the role(s) from kitteh-node-2 to a new node (ex. `kitteh-node-2/server` -> `kitteh-node-3/server`, etc), and run the install script again. ### Custom cluster setup / Forking -This is a guide. You can change more stuff if you'd like, but this will get you started. - +This is a guide. You can change more stuff if you'd like, but this will get you started. + 1. First, fork this Git repository if you haven't already. 2. Modify `serverinfra/config/infrastructure.ini` to fit your needs. ## Troubleshooting - I can't login via SSH! - Your SSH public keys are automatically copied over! If not, did you generate an SSH keyring before installing? - - Additionally, password authentication is disabled! \ No newline at end of file + - Additionally, password authentication is disabled!