version |
---|
v0.1.3 |
Helmsman is a Helm Charts (k8s applications) as Code tool which adds a layer of abstraction on top of Helm (the Kubernetes package manager). It allows you to automate the deployment/management of your Helm charts.
Helmsman was created to ease continous deployment of Helm charts. When you want to configure a continous deployment pipeline to manage multiple charts deployed on your k8s cluster(s), a CI script will quickly become complex and difficult to maintain. That's where Helmsman comes to rescue. Read more about how Helmsman can save you time and effort.
- Built for CD: Helmsman can be used as a docker image or a binary.
- Applications as code: describe your desired applications and manage them from a single version-controlled declarative file.
- Easy to use: deep knowledge of Helm CLI and Kubectl is NOT manadatory to use Helmsman.
- Plan, View, apply: you can run Helmsman to generate and view a plan with/without executing it.
- Portable: Helmsman can be used to manage charts deployments on any k8s cluster.
- Idempotency: As long your desired state file does not change, you can execute Helmsman several times and get the same result.
- Continue from failures: In the case of partial deployment due to a specific chart deployment failure, fix your helm chart and execute Helmsman again without needing to rollback the partial successes first.
- install/delete/upgrade/rollback your helm charts from code.
- [pass secrets/user input to helm charts from environment variables](https://github.com/Praqma/helmsman/blob/master/docs/how_to/pass_secrets_from env_variables.md).
- test releases when they are first installed.
- use public and private helm charts.
- use locally developed helm charts (the tar archives).
- define namespaces to be used in your cluster.
- move charts across namespaces.
Helmsman can be used in three different settings:
- As a binary with Minikube.
- As a binary with a hosted cluster.
- As a docker image in a CI system or local machine.
Helmsman uses a simple declarative TOML file to allow you to describe a desired state for your k8s applications as in the example file.
The desired state file follows the desired state specification.
Helmsman sees what you desire, validates that your desire makes sense (e.g. that the charts you desire are available in the repos you defined), compares it with the current state of Helm and figures out what to do to make your desire come true.
To plan without executing:
$ helmsman -f example.toml
To plan and execute the plan:
$ helmsman -apply -f example.toml
To show debugging details:
$ helmsman -debug -apply -f example.toml
Install Helmsman for your OS from the releases page. Available for Linux and MacOS.
Also available as a docker image.
Documentation and How-Tos can be found here.
Contribution and feeback/feature requests are welcome.