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/tokens
will be ignored by Git so don't worry :).
- During the build process Vagrant will copy relevant tokens into the
master
vm. - Please copy all required keys below to
/<repo-location>/secrets/tokens
before 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 up
Initialization is done for you.
- The host directory
/<repo-location>/work
is mounted at/vagrant_work
on each virtual machine. - When
master
is created it will create/<repo-location>/work/join.sh
. /<repo-location>/work/join.sh
will 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 -f
See Vagrant: Destroy for additional information.