README
¶
Webhooks Extension
The Webhooks Extension for Tekton allows users to set up GitHub or Gitlab webhooks that will trigger Tekton PipelineRuns and associated TaskRuns. This is possible via an extension to the Tekton Dashboard and via REST endpoints.
See our Getting Started guide for more on what this extension does, and how to use it.
Install Prereqs
Install Webhook Extension
To install an official release please navigate to the docs for that release. In the branches dropdown at the top of this page, simply select the branch name matching the version you want to install.
Note that if you're going from Triggers 0.4 to Triggers 0.5 (for example, as part of upgrading the webhooks extension), you must:
- delete any existing TriggerTemplates with
type:in them, to avoid
for: "STDIN": admission webhook "webhook.triggers.tekton.dev" denied the request: mutation failed: cannot decode incoming new object: json: unknown field "type"
errors.
kubectl delete deployment webhooks-extension(which will be in either thetekton-pipelinesoropenshift-pipelinesnamespace depending on your platform). This is to prevent an immutable field type error.
Installing Official Release (stable)
Installing Development Build (nightly)
As a convenience, the /test/install_dashboard_and_extension.sh script can be used to install a specified version of the dashboard and the webhook extension.
Usage Guides
Getting Started
Parameters Available To Trigger Templates
Labelling Pipeline Runs For UI Display
Multiple Pipelines
Pull Request Status Updates
Security
Additional Notes If Using Red Hat OpenShift
Additional Notes If Using Amazon EKS
Limitations
Architecture Guide
Uninstall
Want to get involved?
Visit the Tekton Community project for an overview of our processes.
Information for developers
If you are looking to develop or contribute to this repository please see the development docs
For more involved development scripts please see the development installation guide
Directories