Skip to main content

A simple kubernets deployment manager

Project description


Build Status Coverage Status

kasane [ 重ね ] (n.) pile; heap; layers

This is not an official Google product

Kasane is a layering tool for kubernetes. It allows you to use the officially published YAML documents and extend them further with your local configuration.

Kasane can utilise Jsonnet for deep object modification and patching.


Kasane requires Python 3+. Install via pip:

pip install kasane

Installation via Homebrew:

brew tap google/kasane
brew install google/kasane/kasane

Running from a Docker container

You can run kasane from a docker container, the official image is The image is based on alpine and comes pre-packaged with bash, curl, git and kubectl in addition to kasane itself. The workdir is set to /app and the default command is kasane show so you can quickly examine your local Kasanefiles like this:

$ docker run --rm -ti -v $PWD/examples/03-environment:/app
  defaultFromKasanefile: value
kind: VendoredObject
  name: PreconfiguredObject

Tagged builds for versions starting with 0.1.4 are also available as e.g.


  • Simple Layers is an introduction to kasane features.
  • Jsonnet Transformations shows how to use Jsonnet to transform objects.
  • Environment explains how to use the external environment for customized pipelines.
  • Complex Service shows all the features together by using the upstream configuration for kubernetes dashboard, adding an ingress, and optionally enabling istio sidecar.

Similar tools


Helm is fully-featured package management solution for kubernetes. Compared to it, kasane is a swiss army knife. It's simple, lightweight, doesn't install helper code into your production. Kasane allows you to use original YAML files written by application authors, modifying them to your local needs. If you see a kubectl apply -f http:// example you can turn it into a Kasane deployment with a single line of code and then extend it to your needs.

Kasane doesn't do any templating, relying on Jsonnet for data manipulation. You won't ever need to count number of spaces to make sure your yaml go template is rendered correctly.


Kasane is similar to Ksonnet but is much simpler to use. Kasane allows to re-use original YAML files and minimizes amount of custom Jsonnet code you need to write. Most of the time your Kasane project would consist of a Kasanefile and single yaml or jsonnet file. Still, Kasane allows runtime flexibility with conditional layers and custom environment.


Kasane is distributed under Apache-2 license. See the contributing guidelines on how you can contribute to the project.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kasane, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size kasane-0.1.5.tar.gz (8.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page