These files will allow you to use Terraform to deploy a Kubernetes cluster using k3s, The certified Kubernetes distribution built for IoT & Edge computing!
The deployment will deploy k3s and the entire server-side of the Sprint/Equinix Metal drone IoT demo. When it is done, you will be able to visit https://gateway.yourdomain.com/function/render-map to view the demo.
Terraform is just a single binary. Visit their download page, choose your operating system, make the binary executable, and move it into your path.
Here is an example for macOS:
curl -LO https://releases.hashicorp.com/terraform/0.12.18/terraform_0.12.18_darwin_amd64.zip
unzip terraform_0.12.18_darwin_amd64.zip
chmod +x terraform
sudo mv terraform /usr/local/bin/Terraform uses modules to deploy infrastructure. In order to initialize the modules your simply run: terraform init. This should download five modules into a hidden directory .terraform
This is set to run pretty well out of the box. You need to set are auth_token & project_id to connect to Equinix Metal. Both of these variables can be found in the Equinix Metal UI. You will also need to set the domain_name of the domain you are using to host the demo and an email to submit with your SSL certificate requests to the Let's Encrypt certificate authority.
The auth token can be found using the dropdown at the top right of the screen under API Keys. If you don't have one, you can create one by clicking + Add.
The project id is a little more hidden. The best way to find this is by being logged into the Equinix Metal UI and be on the SERVERS section inside the project you want to deploy into. Then copy the UUID after https://console.equinix.com/projects/ in the address bar.
The node_count defaults to 1 node, but should be set at at least 3-5 nodes for a production setup depending on the size of the dataset to be ingested.
Once you have collected your variables the easiest way to save them for future uses is by using the special terraform.tfvars file. You can create this by copy and pasting the following command, (Make sure you replace the <auth_token> and <project_id> in the command below):
cat <<EOF >terraform.tfvars
auth_token = "<auth_token>"
project_id = "<project_id>"
domain_name = "example.com"
email = "[email protected]"
EOFAll there is left to do now is to deploy the cluster:
terraform apply --auto-approveThis should end with output similar to this:
Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
Outputs:
Get_Access = ssh -i ssh_priv_key [email protected]
You can now login to the first node in the cluster by copy and pasting the ssh command from the output.
Start by installing kubectl on your local machine, which is more convenient than logging into the master each time.
Next install k3sup
curl -SLsf https://get.k3sup.dev | sudo shNow fetch the KUBECONFIG to the local directory:
export IP=147.75.195.75
k3sup install --ip $IP --user root \
--skip-install \
--context packet-iot \
--ssh-key ./ssh_priv_keyk3sup will download an correctly configured KUBECONFIG file to your local directory.
export KUBECONFIG=`pwd`/kubeconfig
kubectl get node -o wideYou can also merge the config to your local ~/.kube/config file with:
export IP=147.75.195.75
k3sup install --ip $IP --user root \
--skip-install \
--ssh-key ./ssh_priv_key \
--merge \
--context packet-iot \
--local-path $HOME/.kube/configSee the new context via:
kubectl config get-contexts
kubectl config set-contexts NAME| Variable Name | Default Value | Description |
|---|---|---|
| auth_token | n/a | Equinix Metal API Key |
| project_id | n/a | Equinix Metal Project ID |
| hostname | k3s | The hostname for nodes |
| node_size | t1.small.x86 | The size or type or flavor of the node |
| facility | ewr1 | The location or datacenter for the node |
| node_count | 1 | How many nodes to be in the k3s cluster |
| k3s_version | v1.0.0 | The GitHub release version of k3s to install |
| operating_system | ubuntu_16_04 | The Operating system of the node (Only Ubuntu 16.04 has been tested) |
| billing_cycle | hourly | How the node will be billed (Not usually changed) |