Articles
M4 as a replacement for sed
Writing a tutorial often involves to replace a placeholder in a file, such as: Replace FOO with the actual name of your image: sed 's|IMAGE_NAME|docker.io/foo/bar:latest|g' template.yaml |kubectl apply -f - But this approach has several drawbacks: If you have to replace multiple placeholders, the sed syntax becomes cumbersome. If the delimiter appears in your replacement string, you will have to find another delimiter (such as in the previous example where the usual slash has been replaced by a pipe to accomodate the slash in the image name). Continue reading
Writing workshop instructions with Hugo and deploying in OpenShift
This is the third part of my series covering how to Write workshop instructions with Hugo. In this article, we will deploy our Hugo mini-training as a container in OpenShift. Continue reading
Writing workshop instructions with Hugo, with variables in your content
This is the second part of my series covering how to Write workshop instructions with Hugo. In the first part, we saw how to: bootstrap a website with Hugo add content, organized in chapters and sections customize the look and feel to be suitable for workshop instructions For this second part, we will add variables to our content so that we can easily adjust the workshop instructions to different use cases. Continue reading
Writing workshop instructions with Hugo
In my professional life, I often have to lead workshops with customers or partners. During those workshops, participants expect to be trained on a piece of technology or software. I usually have to provision everything needed to deliver this training and write the training instructions. Those instructions are organized as a step-by-step guide with screenshots, text, verbatim sections, links, files to downloads, etc. And maybe more important, those instructions have to be well organized, each step has to be clearly stated, identified and formatted. The progression needs to be logic and easy. At any time, the participant needs to know where he is, which steps he has completed and which steps remain. And for the trainer, it has to be easy to maintain and collaborative. Crafting support materials that can meet all those requirements is challenging. Slide decks could fit the participants needs but are very difficult to maintain for the trainer. Markdown documentation in a GIT repository are better for suited for maintenance and collaboration but is difficult to work with for the participants. Hopefully Hugo can help us! Continue reading
Use Ansible to manage the QoS of your OpenShift workload
As I was administering my OpenShift cluster, I found out that I had a too much memory requests. To preserve a good quality of service on my cluster, I had to tacle this issue. Continue reading