OpenFaaS Workshop with in-browser version of VSCode from coder.com
All tools are pre-installed with OpenFaaS on Kubernetes (k3s) available in the browser terminal.
How it works
- A Virtual Machine will be provisioned with a cloud hosting provider using cloudinit
- Kubernetes with k3s will be installed on the VM
- OpenFaaS will be installed into the k3s cluster
- A Docker image will be run which provides VSCode via a web-browser
- The login password for VSCode will be obtained via
- VSCode can now be used in web-browser via your VM's IP. The self-signed certificate will provide encryption and the login password will protect against tampering.
Why do we need this?
This project provides a pre-installed Kubernetes environment within a VM so that your students can focus on your workshop.
The example in this repository is for The OpenFaaS Workshop. It is estimated that it would save students 1.5-2 hours of set-up time. Instructors could also pre-provision a set amount of VMs ahead of time and then give out IP address and password combinations.
Steps to provision on DigitalOcean
- Get 100 USD free credit for 60 days
- Create a DigitalOcean VM size 4GB RAM in your local region
- Add "user data" from
- Pick "ssh" login or via root password over email
- Locate the public IP given and navigate to
- You will need to accept the self-signed certificate, which will display as "insecure". Despite the warning, it will provide encryption for your connection.
- You may have to wait for several minutes before the endpoint to comes up. See the second on Debugging if you want to check the logs.
- Open a Terminal within VSCode and run through the files in ~/project/openfaas/
- Next start the workshop from Lab 2
Get your password
Get the container's logs with:
export IP="" ssh root@$IP "docker logs vscode | grep Password" INFO Password: 7d6ae6958e8d7e882ba08f57
Note: the password shown is an example, you will have your own password.
Debug / get the cloudinit logs
- Log into instance
- View the logs for cloudinit
tail -f /var/log/cloud-init-output.log
Setup a VM using a script in the London region:
# ./provision-digitalocean.sh Creating: of-workshop-ebddfcaf ============================== Droplet: of-workshop-ebddfcaf has been created IP: 220.127.116.11 URL: https://18.104.22.168:8443 Login: ssh firstname.lastname@example.org ============================== To destroy this droplet run: doctl compute droplet delete -f 150218836
You'll be emailed the root password, which you can use to log in and get the VSCode password.
Customize for your own workshops and training sessions
There are two parts you can customize:
- The Docker image:
alexellis2/coder:0.2.0, which is built from Dockerfile
The Docker image provides the VSCode hosting and the CLI tools within the built-in terminal. The Docker image is derrived from coder.com.
- The ./cloudinit.txt which configures the VM
For instance, if you wanted to run a workshop on How to design helm charts - you may comment out the references to OpenFaaS and install helm/tiller into the Docker image.