timbyr / kapitan

Generic templated configuration management for Kubernetes, Terraform and other things

Kapitan: advanced configuration management tool

Kapitan aims to be your one-stop tool to help you manage the ever growing complexity of your configurations.

Join the community #kapitan

Official site https://kapitan.dev

Quick Start

Install Kapitan

Docker (recommended)

docker run -t --rm -v $(pwd):/src:delegated kapicorp/kapitan -h

On Linux you can add -u $(id -u) to docker run to preserve file permissions.

Pip

Kapitan needs Python 3.7.

Install Python 3.7

• Linux: sudo apt-get update && sudo apt-get install -y python3.7-dev python3-pip python3-yaml git
• Mac: brew install python3 libyaml git libmagic

Install Kapitan

User ($HOME/.local/lib/python3.7/bin on Linux or $HOME/Library/Python/3.7/bin on macOS):

pip3 install --user --upgrade kapitan

System-wide (not recommended):

sudo pip3 install --upgrade kapitan

Build Kapitan

Docker

To build a docker image for the architecture of your machine, run docker build . -t you-kapitan-image, and to build for a specific platform, add --platform linux/arm64.

To build a multi-platform image (as the CI does), follow the docker multi-platform documentation.

Related projects

• Tesoro - Kubernetes Admission Controller for Kapitan Secrets
• Kapitan Reference - our reference repository to get started with Kapitan