install.md

{{% comment %}} To view the full contents of this page, go to the Tekton website. {{% /comment %}}

{{% pageinfo %}} {{% readfile "/vendor/disclaimer.md" %}} {{% /pageinfo %}}

This guide explains how to install Tekton Pipelines.

Prerequisites

• A [Kubernetes cluster][k8s] running version 1.23 or later.
• [Kubectl][].
• Grant cluster-admin privileges to the current user. See the [Kubernetes role-based access control (RBAC) docs][rbac] for more information.
• (Optional) Install a [Metrics Server][metrics] if you need support for high availability use cases.

See the [local installation guide][local-install] if you want to test Tekton on your computer.

Installation

{{% tabs %}}

{{% tab "Kubernetes" %}} To install Tekton Pipelines on a Kubernetes cluster:

1. Run one of the following commands depending on which version of Tekton Pipelines you want to install:

   • Latest official release:

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

   • Nightly release:

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

   • Specific release:

      kubectl apply --filename https://storage.googleapis.com/tekton-releases/pipeline/previous/<version_number>/release.yaml

     Replace <version_number> with the numbered version you want to install. For example, v0.26.0.

   • Untagged release:

     If your container runtime does not support image-reference:tag@digest:

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

2. Monitor the installation:

   kubectl get pods --namespace tekton-pipelines --watch

   When all components show 1/1 under the READY column, the installation is complete. Hit Ctrl + C to stop monitoring.

Congratulations! You have successfully installed Tekton Pipelines on your Kubernetes cluster.

{{% /tab %}}

{{% tab "Google Cloud" %}}

{{% readfile file="/vendor/google/pipelines-install.md" %}}

{{% /tab %}}

{{% tab "OpenShift" %}}

{{% readfile file="/vendor/redhat/pipelines-install.md" %}}

{{% /tab %}}

{{% /tabs %}}

Additional configuration options

You can enable additional alpha and beta features, customize execution parameters, configure availability, and many more options. See the addition configurations options for more information.

Next steps

To get started with Tekton check the Introductory tutorials, the how-to guides, and the examples folder.

---

{{% comment %}} Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. {{% /comment %}}