Installing the Pipelines Operator

OpenShift Pipelines can be installed by using the operator listed in the OpenShift OperatorHub. When you install the pipelines operator, the custom resources required for the pipeline configuration are automatically installed along with the operator.

Prerequisites

  • An OpenShift 4 cluster is required for installation. Visit try.openshift.com for information on setting up an OpenShift 4 cluster.

  • You must have cluster administrator privileges to install and use the Pipelines Operator.

  • Download the Tekton CLI tkn and add it’s location to your PATH environment variable.

Procedure

  1. In the Administrator perspective of the Web Console, navigate to Operators > OperatorHub.

  2. Use the Filter by keyword box to search for OpenShift Pipelines Operator in the catalog. Click on the OpenShift Pipelines Operator tile.

    openshift pipelines operator tiles

  3. In the Show Community Operator dialog box, click Continue.

  4. The OpenShift Pipelines Operator screen providing a brief description of the operator is displayed. Click Install.

    openshift pipelines install subscription

  5. In the Create Operator Subscription screen, ensure that:

    • the Installation Mode selected is All namespaces on the cluster (default), as the OpenShift Pipelines operator needs to watch for Tekton Custom Resources across all namespaces.

    • the Approval Strategy is Automatic so that future upgrades to the operator are handled automatically by the the Operator Lifecycle Manager (OLM). If you select Manual; when a new version of the Operator is available, you will need to manually approve the OLM update request to update to the new version.

      OpenShift Pipelines 0.5.2 has introduced changes incompatible with older versions. If the installed version is 0.5.0 or below, the operator will not be automatically upgraded. To upgrade from the 0.5.0 or below, uninstall the operator and then install it again.

  6. Click Subscribe. You will see the operator listed on the Installed Operators page.

    The operator is installed automatically into the openshift-operators namespace.

  7. In the Subscription Overview screen, verify the installation of the operator by confirming that the UPGRADE STATUS is 1 installed.