# k3os utilities

## Folders
* Install: Contains txt files representing Helm charts or applications that can be installed.
* Utilities: Applications or scripts that could be useful for administration.

## Steps to Create Cluster
1. Create one or more masters, boot to k3os, install k3os as 'server'. Remember "token/cluster secret" must be same amongst all nodes in cluster.
2. Create one or more workers, boot to k3os, install k3os as 'agent'. Use 'https://MASTER_IP_ADDRESS:6443' as 'URL of Server' and same token/cluster secret as master. Replace 'MASTER_IP_ADDRESS' with the IP address of the master. 

## Tips
* If downloading scripts to the host and using Proxmox as the hypervisor, use 'utilities/noVNC Paste for Proxmox-0.2a.user.js' for TamperMonkey to enable pasting into the Proxmox terminal.
* Click the script file name in Gitea, then use the 'Raw' button and copy the URL to get the public file.
* Allow execution of the script by using 'chmod +x SCRIPT_FILE_NAME'.
* Use 'ipconfig.sh' to change the IP address of the nodes from DHCP to static and define them. Run with sudo.
* Use 'set_hostname.sh' to change the hostname of the nodes. Run with sudo.
* To allow workers to use kubectl, first run 'toggle_sshd_password_auth.sh' on the master to enable password SSH authentication, then run 'download_kubeconfig_from_master.sh' on the workers to download the kubeconfig from the master.
* Use the script in 'install/helm.txt' to install Helm on the master.
* Use the commands in 'install/rancher.txt' to install Rancher on the cluster.