1
0
mirror of https://github.com/tektoncd/catalog.git synced 2024-11-27 06:27:23 +00:00
catalog/helm
popcor255 2f1f8b32fc Updated helm catalog to access external helm repos
As a user, I would like to use helm repos to deploy my applications. A helm chart was added to support this usecase. As a user having a chart called helm-update and helm-update repo is confusing. Helm charts were renamed and the tests were updated. As a user having all caps params can be confusing because they are reserved for environment variables. Charts were updated for increased readadbility.
2020-07-10 08:25:57 +01:00
..
example Updated helm catalog to access external helm repos 2020-07-10 08:25:57 +01:00
tests Updated helm catalog to access external helm repos 2020-07-10 08:25:57 +01:00
helm-upgrade-from-repo.yaml Updated helm catalog to access external helm repos 2020-07-10 08:25:57 +01:00
helm-upgrade-from-source.yaml Updated helm catalog to access external helm repos 2020-07-10 08:25:57 +01:00
OWNERS This Task can be used to install/upgrade a helm chart into a Kubernetes/OpenShift Cluster. 2020-06-19 10:58:57 +01:00
README.md Updated helm catalog to access external helm repos 2020-07-10 08:25:57 +01:00

Helm

These tasks will install / upgrade a helm chart into your Kubernetes / OpenShift Cluster using Helm.

Install the Task

helm install / upgrade from source code

kubectl apply -f https://raw.githubusercontent.com/tektoncd/catalog/master/helm/helm-upgrade-from-source.yaml

Parameters

  • charts_dir: The directory in the source repository where the installable chart should be found.
  • release_version: The version of the release (default: v1.0.0)
  • release_name: The name of the release (default: helm-release)
  • release_namespace: The namespace in which the release is to be installed (default: "")
  • overwrite_values: The values to be overwritten (default: "")
  • helm_version: The helm version which should be used (default: latest)

Workspaces

  • source: A Workspace volume containing the helm chart.

helm install / upgrade from repo

kubectl apply -f https://raw.githubusercontent.com/tektoncd/catalog/master/helm/helm-upgrade-from-repo.yaml

Parameters

  • chart_name: The directory in the source repository where the installable chart should be found.
  • release_version: The version of the release (default: v1.0.0)
  • release_name: The name of the release (default: helm-release)
  • release_namespace: The namespace in which the release is to be installed (default: "")
  • overwrite_values: The values to be overwritten (default: "")
  • helm_version: The helm version which should be used (default: latest)

Usage

PipelineRun

An example Pipeline with a PipelineRun can be found in the subdirectory tests.

TaskRun

This TaskRun runs the task to retrieve a Git repo and then installs/updates the helm chart that is in the Git repo.

# example upgrade from source
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: example-helm-upgrade-from-source
spec:
  taskRef:
    name: helm-upgrade-from-source
  params:
  - name: charts_dir
    value: helm-sample-chart
  - name: releases_version
    value: v1.0.0
  - name: release_name
    value: helm-source-sample
  - name: overwrite_values
    value: "autoscaling.enabled=true,autoscaling.maxReplicas=3"
  workspaces:
  - name: source
    persistentVolumeClaim:
      claimName: my-source
# example upgrade from repo
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: example-helm-upgrade-from-repo
spec:
  taskRef:
    name: helm-upgrade-from-repo
  params:
  - name: helm_repo
    value: https://kubernetes-charts.storage.googleapis.com
  - name: chart_name
    value: stable/envoy
  - name: release_version
    value: v1.0.0
  - name: release_name
    value: helm-repo-sample
  - name: overwrite_values
    value: autoscaling.enabled=true,autoscaling.maxReplicas=3