The GitOps Toolkit Helm reconciler, for declarative Helming
Go to file
Hidde Beydals 1a88b40936 Support optional values references
This commit adds support for optional values references, as discussions
have brought to light that there are some valid use cases in which
having this option is desirable. For example to allow a user to extend
behaviour at a later date with their own repository without modifying
the HelmRelease object.

When a values reference is marked as optional, not found errors for the
value reference are ignored, but any ValuesKey, TargetPath or transient
error will still result in a reconciliation failure.
2020-09-23 10:00:52 +02:00
.github/workflows Publish ARM v7/v8 multi-arch image to GHCR 2020-09-21 09:35:45 +03:00
api Support optional values references 2020-09-23 10:00:52 +02:00
config Support optional values references 2020-09-23 10:00:52 +02:00
controllers Support optional values references 2020-09-23 10:00:52 +02:00
docs Support optional values references 2020-09-23 10:00:52 +02:00
hack api-docs: add overwrites for external packages 2020-09-15 14:55:15 +02:00
.gitignore Init 2020-05-05 22:35:49 +02:00
CHANGELOG.md Release v0.0.9 2020-09-22 12:29:29 +02:00
CODE_OF_CONDUCT.md Add DCO and code of conduct 2020-07-10 09:18:34 +03:00
DCO Add DCO and code of conduct 2020-07-10 09:18:34 +03:00
Dockerfile Publish amd64/arm64 images to GHCR 2020-09-04 13:44:17 +03:00
LICENSE Support Helm install action 2020-07-08 16:23:38 +02:00
MAINTAINERS Update MAINTAINERS 2020-09-08 08:22:43 -05:00
Makefile Remove `find -execdir` from `Makefile` 2020-09-11 14:40:11 +02:00
PROJECT Change CRD domain to 'helm.toolkit.fluxcd.io' 2020-07-30 22:38:11 +02:00
README.md Support Helm charts from Bucket sources 2020-09-23 09:28:44 +02:00
go.mod Support Helm charts from Bucket sources 2020-09-23 09:28:44 +02:00
go.sum Support Helm charts from Bucket sources 2020-09-23 09:28:44 +02:00
main.go Add watch all namespaces flag 2020-09-11 16:02:05 +03:00

README.md

helm-controller

e2e report license release

The helm-controller is a Kubernetes operator, allowing one to declaratively manage Helm chart releases. It is part of a composable GitOps toolkit and depends on source-controller to acquire the Helm charts from Helm repositories.

The desired state of a Helm release is described through a Kubernetes Custom Resource named HelmRelease. Based on the creation, mutation or removal of a HelmRelease resource in the cluster, Helm actions are performed by the operator.

overview

Features

  • Watches for HelmRelease objects and generates HelmChart objects
  • Supports HelmChart artifacts produced from HelmRepository, GitRepository and Bucket sources
  • Fetches artifacts produced by source-controller from HelmChart objects
  • Watches HelmChart objects for revision changes (including semver ranges for charts from HelmRepository sources)
  • Performs automated Helm actions, including Helm tests, rollbacks and uninstalls
  • Offers extensive configuration options for automated remediation (rollback, uninstall, retry) on failed Helm install, upgrade or test actions
  • Runs Helm install/upgrade in a specific order, taking into account the depends-on relationship defined in a set of HelmRelease objects
  • Reports Helm release statuses (alerting provided by notification-controller)

Guides

Specifications