Tutorial review notes

[joekent123]

00-Setup

• Running the setup script requires podman or docker to be running however the instructions don’t appear to tell you that.
• Should it include some basic commands for starting up a podman or docker machine?
• Creating a new podman machine with a different name to the default appeared to cause the setup script to fail and not identify the running machine. Using the podman default machine did work.
• The tutorial would only work for me after upgrading from podman 5 to 6 (with the fix from Alex’s PR).
• I also upped my podman machine’s memory to 12G instead of 8G in case memory was an issue.

The readme in the /lessons directory has the ‘How the series works’ section which explains that a shared cluster is set up once and used for all lessons. This doesn’t really match the teardown instructions at the end of lessons 1 and 2.

Lesson 1

• In the cleanup section I don’t think the ../00-setup/teardown.sh command works out of the box because earlier in the tutorial the user was cd’d to their tmp directory.

Lesson 2

• In the setup section it says that prep.sh will ‘remove the lesson 1 state from the cluster’ however at the end of lesson 1 it suggested you use the teardown script to remove the cluster and start again. Given that teardown and setup take 5-10 minutes it might be better not to suggest the teardown and re-setup if the prep script can work on an existing cluster from a previous lesson.
• tree manifests/ this command does not work out of the box on mac. It can be installed via homebrew though.