# 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
* 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.