GitOps Promoter Helm Chart

GitOps Promoter is a Kubernetes controller for automating GitOps-based application promotion across environments.

Source code can be found here:

• https://github.com/argoproj-labs/gitops-promoter-helm
• https://github.com/argoproj-labs/gitops-promoter

This is the official Helm chart for the GitOps Promoter project.

Installation

Unfortunately, some technical choices from kubebuilder prevent us from providing installing with helm install. We approve the choice made, and we might provide a better solution once the feature for creation sequencing is implemented.

We recommend to install the chart using Argo CD:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: gitops-promoter
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://argoproj-labs.github.io/gitops-promoter-helm/
    chart: gitops-promoter
    targetRevision: "*" # Or a specific version
  destination:
    server: "https://kubernetes.default.svc"
    namespace: promoter-system
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

Or you can install the chart using kubectl:

helm repo add gitops-promoter-helm https://argoproj-labs.github.io/gitops-promoter-helm/
helm repo update
# Initial apply to install CRDs. It's expected to fail, since we install the ControllerConfiguration CRD and a ControllerConfiguration CR in the same apply.
kubectl create namespace promoter-system
helm template  gitops-promoter-helm/gitops-promoter --namespace promoter-system | kubectl apply -f - || true 
helm template  gitops-promoter-helm/gitops-promoter --namespace promoter-system | kubectl apply -f -

Known Limitations

kube-rbac-proxy image and resources are not configurable

The chart currently deploys a kube-rbac-proxy sidecar container whose image and resource requests/limits cannot be overridden via values.yaml. This is a limitation inherited from how kubebuilder generates the Helm chart.

Tracking issue for removing kube-rbac-proxy from the upstream project: argoproj-labs/gitops-promoter#1085

Updates

This project uses Kubebuilder and the helm plugin to create/update the charts. The helm chart will be automatically updated when new GitOps Promoter versions are released.

Please see:kubebuilder helm plugin documentation for more information on how to update the chart.

Verifying the chart signature

# Public key is at https://argoproj-labs.github.io/gitops-promoter-helm/pgp_keys.asc
helm repo add gitops-promoter https://argoproj-labs.github.io/gitops-promoter-helm/
helm repo update
helm verify gitops-promoter/gitops-promoter  # verify before install