IMPORTANT: This repository requires a read-through of SLATE Cluster Installation beforehand and if you have questions reach out to the team via SLACK, in an email, or during the working-sessions.
Tools to create K8s with VirtualBox via HashiCorp Vagrant and register with SLATE.
See Virtual Box for download and installation instructions.
-
Download vagrant and follow the installer's instructions.
-
Install the Virtualbox Guest Additions via the following command:
vagrant plugin install vagrant-vbguest
Note: you will receive the mount errors described in Vagrant No VirtualBox Guest Additions installation found.
-
Enable autocompletion:
vagrant autocomplete install --bash
NOTE: All files added to
/<repo-location>/secrets/tokenswill be ignored by Git so don't worry :).
- During the build process Vagrant will copy relevant tokens into the
mastervm. - Please copy all required keys below to
/<repo-location>/secrets/tokensbefore building the images.
| Name | Required | Description |
|---|---|---|
slate-cli |
Yes | SLATE CLI token acquired from the SLATE Portal. |
Bring up the three virtual machines master, worker1, and worker2:
vagrant upInitialization is done for you.
- The host directory
/<repo-location>/workis mounted at/vagrant_workon each virtual machine. - When
masteris created it will create/<repo-location>/work/join.sh. /<repo-location>/work/join.shwill be used by the workers to join the Kubernetes cluster automatically.
SSH into the master node and run the commands described in SLATE: Cluster Federation.
Tearing down the virtual machines and clearing the old /<repo-location>/work/join.sh is done with a single command:
vagrant destroy -fSee Vagrant: Destroy for additional information.