fkrestan / cloud-native-prague-11

Cloud Native Prague #11

Tanka: for those who hate stirng templating but don't mind braces

This repository contains all resources for my talk at Cloud Native Prague meetup #11.

The recording from the talk is available on Cloud Native Prague YouTube channel.

Talk Abstract

Kubernetes API resource manifests are structured data. String templating is admittedly not the best way to generate those. There now exists a whole class of purpose built languages specifically designed to generate and validate structured data that lend themselves well to generating Kubernetes API resources. Depending on what your use-case is, this might be a killer application for you.

Jsonnet, used by Grafana Tanka, is one such language.

Slides

The slides used during the presentation are in slides.org. This is Emacs Org mode file which is similar to Markdown and can be read with any text processor if you don't have text editor with Org mode at hand.

Examples

The examples directory contains runnable samples of Jsonnet, Go and Tanka used during my presentation.

The Makefile included in this repository provides targets for running the examples e.g. make examples/01-jsonnet-basics/01.jsonnet.

Playground

This repository uses Nix Flakes direnv setup. If you want to run the examples without Nix you can find a list of needed packages in Flake.nix file.

Wile k3d is the chosen local dev cluster setup, the examples can be tested against any Kuernetes cluster. The only requirement to run the examples is Kubernets >= 1.27.

The k3d setup relies on container runtime which the Flake.nix does not install. By default this is Docker. See k3d docs for alternatives.

The Makefile included in this repository provides targets for bringing up a testing k3d cluster:

# To start the local k3d cluster
make k3d-up

# To cleanup the local k3d cluster
make k3d-clean