ContextQMD
Back to Pipeline

Install

docs/install.md

1.12.04.0 KB
Original Source
<!-- --- title: "Install Tekton Pipelines" linkTitle: "Install Tekton Pipelines" weight: 101 description: > Install Tekton Pipelines on your cluster --- -->

{{% comment %}} To view the full contents of this page, go to the <a href="http://tekton.dev/docs/installation/pipelines/">Tekton website</a>. {{% /comment %}}

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

This guide explains how to install Tekton Pipelines.

Prerequisites

See the local installation guide 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:

      bash
      kubectl apply --filename https://infra.tekton.dev/tekton-releases/pipeline/latest/release.yaml

      Note: These instructions are ideal as a quick start installation guide with Tekton Pipelines and not meant for the production use. Please refer to the operator to install, upgrade and manage Tekton projects.

    • Nightly release:

      bash
      kubectl apply --filename https://infra.tekton.dev/tekton-releases-nightly/pipeline/latest/release.yaml

    • Specific release:

      bash
       kubectl apply --filename https://infra.tekton.dev/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:

      bash
      kubectl apply --filename https://infra.tekton.dev/tekton-releases/pipeline/latest/release.notags.yaml

Multi-tenant installation is only partially supported today, read the guide for reference.

  1. Monitor the installation:

    bash
    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 additional configuration 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 %}}