# 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)
<img src="docs/images/kapitan_logo.png" width="25">
**`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) <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
Raw data
{
"_id": null,
"home_page": "https://github.com/kapicorp/kapitan",
"name": "kapitan",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "jsonnet, kubernetes, reclass, jinja",
"author": "Ricardo Amaro",
"author_email": "ramaro@kapicorp.com",
"download_url": "https://files.pythonhosted.org/packages/ec/0a/1cedcfaed97ebb8fb1ad0ce73239bba28aa618bbab68d79b00a496926ac7/kapitan-0.34.2.tar.gz",
"platform": null,
"description": "# Kapitan: advanced configuration management tool\n\n[![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)\n![Python Version](https://img.shields.io/pypi/pyversions/kapitan)\n![Downloads](https://img.shields.io/pypi/dm/kapitan)\n![Docker Pulls](https://img.shields.io/docker/pulls/kapicorp/kapitan)\n[![Releases](https://img.shields.io/github/release/kapicorp/kapitan.svg)](https://github.com/kapicorp/kapitan/releases)\n[![Docker Image Size](https://img.shields.io/docker/image-size/kapicorp/kapitan/latest.svg)](https://hub.docker.com/r/kapicorp/kapitan)\n\n<img src=\"docs/images/kapitan_logo.png\" width=\"25\">\n\n\n**`Kapitan`** aims to be your *one-stop tool* to help you manage the ever growing complexity of your configurations.\n\nJoin the community [`#kapitan`](https://kubernetes.slack.com/archives/C981W2HD3)\n\n## [**Official site**](https://kapitan.dev) <https://kapitan.dev>\n\n\n## [**Quick Start**](https://kapitan.dev/getting_started/#quickstart)\n\n## Install Kapitan\n\n### Docker (recommended)\n\n```shell\ndocker run -t --rm -v $(pwd):/src:delegated kapicorp/kapitan -h\n```\n\nOn Linux you can add `-u $(id -u)` to `docker run` to preserve file permissions.\n\n### Pip\n\nKapitan needs Python 3.7.\n\n#### Install Python 3.7\n\n* Linux: `sudo apt-get update && sudo apt-get install -y python3.7-dev python3-pip python3-yaml git`\n* Mac: `brew install python3 libyaml git libmagic`\n\n#### Install Kapitan\n\nUser (`$HOME/.local/lib/python3.7/bin` on Linux or `$HOME/Library/Python/3.7/bin` on macOS):\n\n```shell\npip3 install --user --upgrade kapitan\n```\n\nSystem-wide (not recommended):\n\n```shell\nsudo pip3 install --upgrade kapitan\n```\n\n## Build Kapitan\n\n### Docker\n\nTo 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`.\n\nTo build a multi-platform image (as the CI does), follow [the docker multi-platform documentation](https://docs.docker.com/build/building/multi-platform/).\n\n## Related projects\n\n* [Tesoro](https://github.com/kapicorp/tesoro) - Kubernetes Admission Controller for Kapitan Secrets\n* [Kapitan Reference](https://github.com/kapicorp/kapitan-reference) - our reference repository to get started with Kapitan\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Generic templated configuration management for Kubernetes, Terraform and other things",
"version": "0.34.2",
"project_urls": {
"Documentation": "https://kapitan.dev/",
"Homepage": "https://github.com/kapicorp/kapitan",
"Repository": "https://github.com/kapicorp/kapitan"
},
"split_keywords": [
"jsonnet",
" kubernetes",
" reclass",
" jinja"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cb5e4992bb6dea6397f3c010dcfde75ecf7a31160a441425548e3dd6c263358f",
"md5": "75948b694226f7fb3a17806aff250563",
"sha256": "f76a9b7565edc6f6c7d93752aa6539455c43b1fad57d92a6e9e1354e510da5d4"
},
"downloads": -1,
"filename": "kapitan-0.34.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75948b694226f7fb3a17806aff250563",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 100850,
"upload_time": "2024-11-08T09:04:18",
"upload_time_iso_8601": "2024-11-08T09:04:18.545621Z",
"url": "https://files.pythonhosted.org/packages/cb/5e/4992bb6dea6397f3c010dcfde75ecf7a31160a441425548e3dd6c263358f/kapitan-0.34.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ec0a1cedcfaed97ebb8fb1ad0ce73239bba28aa618bbab68d79b00a496926ac7",
"md5": "c6f600c46c5dbd4838f70d3eba7eb3f5",
"sha256": "bacf3bbb9aef50db968b4468d6b6cd2f250fb3e1779239984cfde3e888974389"
},
"downloads": -1,
"filename": "kapitan-0.34.2.tar.gz",
"has_sig": false,
"md5_digest": "c6f600c46c5dbd4838f70d3eba7eb3f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 72318,
"upload_time": "2024-11-08T09:04:20",
"upload_time_iso_8601": "2024-11-08T09:04:20.782848Z",
"url": "https://files.pythonhosted.org/packages/ec/0a/1cedcfaed97ebb8fb1ad0ce73239bba28aa618bbab68d79b00a496926ac7/kapitan-0.34.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-08 09:04:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kapicorp",
"github_project": "kapitan",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kapitan"
}