Installation

Tanka is distributed as a single binary called tk. It already includes the Jsonnet compiler, but requires some tools to be available:

• kubectl: Tanka uses kubectl to communicate to your cluster. This means kubectl must be available somewhere on your $PATH. If you ever have worked with Kubernetes before, this should be the case anyways.
• diff: To compute differences, standard UNIX diff(1) is required.
• (recommended) jb: #Jsonnet Bundler, the Jsonnet package manager
• (recommended) helm: Helm, required for Helm support

Tanka

MacOS

On macOS, Tanka is best installed using brew:

brew install tanka

This downloads the most recent version of Tanka and installs it. Also, Tanka is automatically kept up to date as part of brew upgrade.

ArchLinux

We maintain two AUR packages, one building from source and another one using a pre-compiled binary.

These can be installed using any AUR helper, e.g. yay:

From Source

yay tanka

Using pre-compiled binaries

yay tanka-bin

Binary

For all other operating systems, we provide pre-compiled binaries for Tanka at GitHub Releases.

Just grab the latest version from there, download it and put somewhere in your $PATH (e.g. to /usr/local/bin/tk)

Linux, macOS

For Linux and macOS, download the binary for your architecture, put it somewhere on your $PATH, and make it an executable:

Linux amd64

sudo curl -Lo /usr/local/bin/tk https://github.com/grafana/tanka/releases/latest/download/tk-linux-amd64
sudo chmod a+x /usr/local/bin/tk

Linux arm / arm64 (e.g. RaspberryPi)

sudo curl -Lo /usr/local/bin/tk https://github.com/grafana/tanka/releases/latest/download/tk-linux-arm
sudo curl -Lo /usr/local/bin/tk https://github.com/grafana/tanka/releases/latest/download/tk-linux-arm64
sudo chmod a+x /usr/local/bin/tk

macOS

sudo curl -Lo /usr/local/bin/tk https://github.com/grafana/tanka/releases/latest/download/tk-darwin-amd64
sudo chmod a+x /usr/local/bin/tk

Go

If you happen to have a local Go toolchain, you can also build Tanka from source using go install:

cd /tmp
go install github.com/grafana/tanka/cmd/tk@latest

If that does not work for whatever reason (Go modules, etc), clone and compile manually:

git clone https://github.com/grafana/tanka
cd tanka
make install

Jsonnet Bundler

The Jsonnet Bundler project creates a package manager for Jsonnet to share and reuse code across the internet, similar to npm or go mod.

Tanka uses this tool by default, so it’s recommended to install it as well:

MacOS

On macOS, Jsonnet Bundler is best installed using brew:

brew install jsonnet-bundler

This downloads the most recent version of Jsonnet Bundler and installs it.
Also, Jsonnet Bundler is automatically kept up to date as part of brew upgrade.

ArchLinux

On ArchLinux, install using the jsonnet-bundler-bin AUR package:

yay jsonnet-bundler-bin

Binary

The jb binary is primarily distributed using GitHub releases.

Linux, macOS

For Linux and macOS, download the binary for your architecture, put it somewhere on your $PATH, and make it an executable:

Linux amd64

sudo curl -Lo /usr/local/bin/jb https://github.com/jsonnet-bundler/jsonnet-bundler/releases/latest/download/jb-linux-amd64
sudo chmod a+x /usr/local/bin/jb

Linux arm / arm64 (e.g. RaspberryPi)

sudo curl -Lo /usr/local/bin/jb https://github.com/jsonnet-bundler/jsonnet-bundler/releases/latest/download/jb-linux-arm
sudo curl -Lo /usr/local/bin/jb https://github.com/jsonnet-bundler/jsonnet-bundler/releases/latest/download/jb-linux-arm64
sudo chmod a+x /usr/local/bin/jb

macOS

sudo curl -Lo /usr/local/bin/jb https://github.com/jsonnet-bundler/jsonnet-bundler/releases/latest/download/jb-darwin-amd64
sudo chmod a+x /usr/local/bin/jb

Go

If you happen to have a local Go toolchain available, you can build from source using go install:

$ cd /tmp
$ go install github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb@latest