diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5be2320e0d0a76aa05491f1cd517240dfde263c8..36f6829b757dcd142a68ab7a50125b2537ec5975 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -79,25 +79,32 @@ use it. This is a manual process for now. Follow these steps: 1. Create a new VPS ``` export HOST_NAME=baseimage20211019 - python -m openappstack ${HOST_NAME} create --create-droplet --create-hostname ${HOST_NAME}.openappstack.net --ssh-key-id 112 --create-domain-records --subdomain ${HOST_NAME} openappstack.net + # Make sure you use your private ssh key id + export SSH_ID=112 + python -m openappstack ${HOST_NAME} create --create-droplet --create-hostname ${HOST_NAME}.openappstack.net --ssh-key-id $SSH_ID --create-domain-records --subdomain ${HOST_NAME} openappstack.net ``` -2. Run the following to install *only kubernetes* on the VPS: + +2. Accept ssh host key + ``` + ssh root@${HOST_NAME}.openappstack.net + ``` + +3. Run the following to install *only kubernetes* on the VPS: ``` python3 -m openappstack ${HOST_NAME} install ``` -3. Log into your machine and clean up the k3s server, then delete the cluster +4. Log into your machine and clean up the k3s server, then delete the cluster data: ``` - ssh $HOST_NAME.openappstack.net + ssh root@${HOST_NAME}.openappstack.net # Clean up running containers and firewall /usr/local/bin/k3s-killall.sh - systemctl disable k3s - # Remove all possible states - rm -rf /var/lib/{rancher,OpenAppStack,kubelet} /etc/rancher /var/log/{OpenAppStack,containers,pods} /tmp/k3s /etc/systemd/system/k3s.service + # Remove k3s state + rm -rf /var/lib/rancher/k3s ``` -3. Log into Cosmos with the OpenAppStack account -4. Go to VPS Cloud -> VPS and shut down your VPS -5. Go to VPS Cloud -> Disk Images and click `Manage` for your VPSs disk image +5. Log into Cosmos with the OpenAppStack account +6. Go to VPS Cloud -> VPS and shut down your VPS +7. Go to VPS Cloud -> Disk Images and click `Manage` for your VPSs disk image 1. Change the Disk Label to something like `k3s-template-DATE` 2. Set VPS to `-- not assigned --` 3. Click save @@ -107,10 +114,11 @@ use it. This is a manual process for now. Follow these steps: 7. Choose OS type Debian 11 (bullseye) 8. Remember the disk image ID that you can see in the current URL as `id=...` 9. Click save -6. Change the `--disk-image-id` argument in `.gitlab/ci_scripts/create_vps.sh` +8. Change the `--disk-image-id` argument in `.gitlab/ci_scripts/create_vps.sh` to your current disk-image-id **with a minus in front of it**. This is because custom images are negative integers, whereas Greenhost's disk images are positive integers +9. Remove the droplet You are now ready to merge the changes you made to the `install-kubernetes` playbook