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.
You can run the instructions above on any cloud that supports cloudinit, or if you have a VM platform that does not allow, or support cloudinit, you can simply run the contents of "cloudinit.txt" as root on the VM after it has booted up.
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
- Deploy the VM
Skip to "After the deployment"
Provision on Civo
- Get 50 USD credits for new sign-ups
- Create a Medium sized VM and get your login details
cloudinitis not available on Civo at this time, but you can log in after the VM is ready and run the script manually instead
sshto connect to the instance, now paste in the content from
cloudinit.txtinto your terminal
Skip to "After the deployment"
After the deployment
- Locate the public IP given and navigate to
https://IP:8443in a web-browser. This will open VSCode.
- 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 [email protected]$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
ssh [email protected]
- 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: 22.214.171.124 URL: https://126.96.36.199:8443 Login: ssh [email protected] ============================== 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.