waypoint-playground

experiments with hashicorp waypoint and nomad. the environment for recording screencasts and experimenting with waypoint is based on lxd containers. your host must be a linux machine since we are using linux-containers(lxc/lxd) for out environment.

To learn about lxd and my reasoning for choosing it over other virtualization methods to experiment with nomad and waypoint, look into lxc-readme document.

this playground and all associated screencasts are based on Hashicorp's tutorials.

directory structure

• contrib : supporting files and artifacts.
• docs : a summary of different waypoint concepts. can be used as quick start guide.
• experiments : collection of documents with accompanying screencasts, showcasing how to use waypoint.
• fixtures : static files , like mermaid.js graphs
• scenes : yaml files passed to spielbash for recording screen casts.
• in case you just want to watch screencasts, you can find their links at experiments/screen-casts.txt

experiments

• initialization - markdown | pdf : covers setting up a remote compute instance in google cloud. we also go through provisioning and installing lxd on it, bootstrapping nomad cluster with 3 server and 3 clients in the remote instance's lxd containers and setting up a container for our waypoint experiments.
• waypoint client setup - markdown | pdf : covers downloading and installing waypoint client
• waypoint server setup - markdown | pdf : covers setting up waypoint server on nomad cluster
• pack build plugin and nomad deploy plugin - markdown | pdf : covers building a rails application with cloudnative buildpacks and deployment of the image on nomad cluster
• multistage docker builder - markdown | pdf : covers using hook to build the image and retagging it with docker-pull. this experiment has a tight synergy with github actions.

references

• https://learn.hashicorp.com/tutorials/waypoint