# 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/21/22/a6549bfb39ea16dc88ed154ee823592d3d8358e79eaf6d4d242d37a67738/kapitan-0.34.4.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.4",
"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": "cb2ba567f6e57136511f6a8c734c495855f993c7c29873664b413cc3c985e510",
"md5": "6fd6f4bd227b233875526f9aa3f44a66",
"sha256": "712e1329376040935737a5b20bff56333e93a490659d4f0c5bcae43efbecd75d"
},
"downloads": -1,
"filename": "kapitan-0.34.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6fd6f4bd227b233875526f9aa3f44a66",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 99157,
"upload_time": "2025-01-07T14:05:24",
"upload_time_iso_8601": "2025-01-07T14:05:24.637132Z",
"url": "https://files.pythonhosted.org/packages/cb/2b/a567f6e57136511f6a8c734c495855f993c7c29873664b413cc3c985e510/kapitan-0.34.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2122a6549bfb39ea16dc88ed154ee823592d3d8358e79eaf6d4d242d37a67738",
"md5": "417f32965a80b42891f024c141c5fd1e",
"sha256": "4810983f5176e71ba7fba158903000a99ee16714f1b53d453044b1875b6cab95"
},
"downloads": -1,
"filename": "kapitan-0.34.4.tar.gz",
"has_sig": false,
"md5_digest": "417f32965a80b42891f024c141c5fd1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 72912,
"upload_time": "2025-01-07T14:05:27",
"upload_time_iso_8601": "2025-01-07T14:05:27.222669Z",
"url": "https://files.pythonhosted.org/packages/21/22/a6549bfb39ea16dc88ed154ee823592d3d8358e79eaf6d4d242d37a67738/kapitan-0.34.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-07 14:05:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kapicorp",
"github_project": "kapitan",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kapitan"
}