The GitOps Toolkit Helm reconciler, for declarative Helming
Go to file
Sean Eagan 10432883c3 Update MAINTAINERS 2020-09-08 08:22:43 -05:00
.github/workflows Publish amd64/arm64 images to GHCR 2020-09-04 13:44:17 +03:00
api Upgrade Kubernetes and Helm dependencies 2020-09-01 20:12:31 +02:00
config Release v0.0.7 2020-09-04 15:35:59 +03:00
controllers Support charts from GitRepository sources 2020-09-01 18:32:17 +02:00
docs spec: update design due to added features 2020-09-03 18:55:33 +02:00
hack Generate API documentation 2020-07-09 15:03:59 +02:00
.gitignore Init 2020-05-05 22:35:49 +02:00
CHANGELOG.md Release v0.0.7 2020-09-04 15:35:59 +03: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 Support targeting a path in ValuesReferences 2020-08-20 10:41:07 +02:00
PROJECT Change CRD domain to 'helm.toolkit.fluxcd.io' 2020-07-30 22:38:11 +02:00
README.md Update README 2020-09-01 23:36:38 +02:00
go.mod Release v0.0.7 2020-09-04 15:35:59 +03:00
go.sum Upgrade Kubernetes and Helm dependencies 2020-09-01 20:12:31 +02:00
main.go Setup production logging 2020-07-13 10:33:59 +02: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 and GitRepository 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