Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 2.6 KB

README.md

File metadata and controls

55 lines (33 loc) · 2.6 KB

Firefly III helm charts

ℹ️ We're working towards a 1.0.0 release of the firefly-iii-stack chart. The firefly-iii and importer charts are already released as 1.x.

Installs Firefly III in kubernetes.

Installation

Add the helm repository with

helm repo add firefly-iii https://firefly-iii.github.io/kubernetes
helm repo update

The charts are then usable as e.g. firefly-iii/firefly-iii-stack:

helm install firefly-iii firefly-iii/firefly-iii-stack

Anatomy

This chart repository contains four charts:

Configuration

Each chart contains a values.yaml file that is set up with best practices in mind. If you want to override them, specify your own values file for the helm command.

Note that if you use the firefly-iii-stack chart, you'll have to put the values in the respective key, e.g. firefly-iii.config for the config values of the firefly-iii chart.

Development and testing

For the firefly-iii-stack chart, you need to override the chart dependencies locally to develop it on your machine.

Please document values with # -- <Documentation here> comments so that helm-docs can automatically pick them up for the README.

When introducing breaking changes, please document them in the README.md.gotmpl file of the respective chart.

Versioning

Helm charts use semantic versioning. For the charts in this repository, we only use the [MAJOR].[MINOR].[PATCH] syntax without any pre-releases.

Please bump as follows:

  • Major version for breaking changes (this includes updates of default values as users may need to manually update their values)
  • Minor version when you add features
  • Patch version for bug fixes and documentation updates

For the automatic releasing and linting to work, do not manually update the firefly-iii-stack to use new dependency versions in the same PR as this will fail validation and releasing.