https://github.com/kapicorp/kapitan

Generic templated configuration management for Kubernetes, Terraform and other things
https://github.com/kapicorp/kapitan

aws-kms declarative devops devops-tools docker gcp-kms gitops gpg helm jinja2 jinja2-templates jsonnet kapitan kubernetes orchestration python python3 reclass terraform yaml

Last synced: 2 days ago
JSON representation

Generic templated configuration management for Kubernetes, Terraform and other things

• Host: GitHub
• URL: https://github.com/kapicorp/kapitan
• Owner: kapicorp
• License: apache-2.0
• Created: 2017-10-09T16:11:42.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T13:47:53.000Z (about 1 month ago)
• Last Synced: 2024-10-29T14:50:10.279Z (about 1 month ago)
• Topics: aws-kms, declarative, devops, devops-tools, docker, gcp-kms, gitops, gpg, helm, jinja2, jinja2-templates, jsonnet, kapitan, kubernetes, orchestration, python, python3, reclass, terraform, yaml
• Language: Python
• Homepage: https://kapitan.dev
• Size: 22 MB
• Stars: 1,822
• Watchers: 34
• Forks: 199
• Open Issues: 90
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Support: docs/support.md
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-repositories - kapicorp/kapitan - Generic templated configuration management for Kubernetes, Terraform and other things (Python)

README

        
# Kapitan: advanced configuration management tool

[![Test, Build and Publish docker image](https://github.com/kapicorp/kapitan/actions/workflows/test-build-publish.yml/badge.svg?branch=master&event=push)](https://github.com/kapicorp/kapitan/actions/workflows/test-build-publish.yml)

![Python Version](https://img.shields.io/pypi/pyversions/kapitan)

![Downloads](https://img.shields.io/pypi/dm/kapitan)

![Docker Pulls](https://img.shields.io/docker/pulls/kapicorp/kapitan)

[![Releases](https://img.shields.io/github/release/kapicorp/kapitan.svg)](https://github.com/kapicorp/kapitan/releases)

[![Docker Image Size](https://img.shields.io/docker/image-size/kapicorp/kapitan/latest.svg)](https://hub.docker.com/r/kapicorp/kapitan)



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

Join the community [`#kapitan`](https://kubernetes.slack.com/archives/C981W2HD3)

## [**Official site**](https://kapitan.dev) 

## [**Quick Start**](https://kapitan.dev/getting_started/#quickstart)

## Install Kapitan

### Docker (recommended)

```shell

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):

```shell

pip3 install --user --upgrade kapitan

```

System-wide (not recommended):

```shell

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](https://docs.docker.com/build/building/multi-platform/).

## Related projects

* [Tesoro](https://github.com/kapicorp/tesoro) - Kubernetes Admission Controller for Kapitan Secrets

* [Kapitan Reference](https://github.com/kapicorp/kapitan-reference) - our reference repository to get started with Kapitan