Setting Up Tekton Triggers

Follow the steps below to set up an official release of Tekton Triggers on your Kubernetes cluster. If you want to test Triggers from HEAD, see the Tekton Developer Guide.

Prerequisites

You must satisfy the following prerequisties to set up Tekton Triggers:

  • You must have a Kubernetes Cluster running Kubernetes 1.18 or above.

You can use kind to quickly create a local cluster with RBAC enabled for testing purposes:

  • Install kind as described in Installation.

  • Create a cluster as described in Creating a Cluster.

  • You must have Tekton Pipelines installed on your Kubernetes cluster.

For instructions, see Installing Tekton Pipelines.

  • You must grant the cluster-admin privilege to the user with which you installed Tekton Pipelines.

For instructions, see Role-based access control.

Installing Tekton Triggers on Your Cluster

  1. Log on to your Kubernetes cluster as the user with which you installed Tekton Pipelines.

  2. Use the kubectl apply command to install the latest release of Tekton Triggers and its dependencies:

    kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/release.yaml
    kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/interceptors.yaml

    To install a specific release of Tekton Triggers, replace latest with the desired version number as shown in the following example:

    kubectl apply -f https://storage.googleapis.com/tekton-releases/triggers/previous/v0.1.0/release.yaml

    To install a nightly release, use the following command:

    kubectl apply --filename https://storage.googleapis.com/tekton-releases-nightly/triggers/latest/release.yaml
  3. Monitor the installation using the kubectl get command:

    kubectl get pods --namespace tekton-pipelines --watch
  4. When all Tekton Triggers components report a status of Running press CTRL+C to stop monitoring.

You are now ready to configure Tekton Triggers for your workflow. For instructions, see the following:

Customizing the Triggers Controller behavior

To customize the behavior of the Triggers Controller, modify the ConfigMap feature-flags-triggers as follows:

  • enable-api-fields: set this flag to “stable” to allow only the most stable features to be used. Set it to “alpha” to allow alpha features (in addition to stable features) to be used. Note that this flag only applies to the v1beta1 apiVersion.

For example:

`yaml apiVersion: v1 kind: ConfigMap metadata: name: feature-flags-triggers data: enable-api-fields: "alpha" # Allow "alpha" fields to be used in v1beta1 Triggers' resources. Defaults to "stable" features only.


Last modified January 1, 0001