FairwindsOps / Reckoner

Command line helper for helm. This utility adds to the functionality of Helm in multiple ways:

• Creates a declarative syntax to manage multiple releases in one place
• Allows installation of charts from a git commit/branch/release

Want to learn more? Reach out on the Slack channel (request invite), send an email to [email protected], or join us for office hours on Zoom

Requirements

• python 3
• helm (>= 3.0.0), installed and initialized

Note: Python2 is no longer supported by Reckoner. Note2: Helm2 support will not be tested from v4.3.0. The maintainers have deprecated helm2.

Installation

Via pip: preferred method

• pip install reckoner

For development see CONTRIBUTING.md.

Quickstart

In course.yaml, write:

namespace: default
charts:
  grafana:
    namespace: grafana
    values:
      image:
        tag: "6.2.5"
  polaris-dashboard:
    namespace: polaris-dashboard
    repository:
      git: https://github.com/FairwindsOps/charts
      path: stable
    chart: polaris

Then run:

reckoner plot course.yaml --run-all

Grafana and Polaris should now be installed on your cluster!

Adopting Reckoner

Warning: Experimental

If you're already using Helm but want to start using reckoner, you can use reckoner import to facilitate your migration.

We recommend carefully examining the output of a reckoner diff before relying on any imported course.yml definitions.

More Documentation

More advanced usage docs and course definition information can be found in the docs/ folder of this repository.

Contributing

• Code of Conduct
• Roadmap
• Contributing