Installing Pipelines

The following section describes how to install and uninstall OpenShift Pipelines.

Installing the Pipelines Operator

OpenShift Pipelines can be installed by using the operator indexed in the OpenShift OperatorHub.

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 Web Console, navigate to Catalog → 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. The OpenShift Pipelines Operator screen providing a brief description of the operator is displayed. Click Install.

    openshift pipelines install subscription

  4. On the Create Operator Subscription screen, ensure the installation mode selected is All namespaces on the cluster (default), then click Subscribe.

    • The operator is installed automatically into the openshift-operators namespace. The option to install in A specific namespace on the cluster should be disabled. The OpenShift Pipelines operator should watch for Tekton Custom Resources across all namespaces.

    • OpenShift Pipelines upgrades are handled automatically through Operator Subscription. New updates will be installed as soon as they become available.

      • 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.

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

Deleting the project and uninstalling the pipelines operator

Deleting the Project

Procedure

  1. In the OpenShift Web Console, navigate to Home > Projects .

  2. Select the pipelines project, on the listed page.

  3. Right click the menu icon on the pipelines row.

  4. Select Delete Project.

  5. Confirm deletion by typing pipelines in the field that appears.

  6. Click Delete.

  7. The project is now deleted from the Projects list and cluster.

Uninstalling the pipelines operator

Procedure

  1. Go to Catalog > OperatorHub in the Web Console.

  2. Click on the OpenShift Pipelines Operator tile. The operator tile will indicate it is installed.

  3. The Show Community Operator` dialog box will appear. Click Continue to proceed.

  4. Once, the OpenShift Pipelines Operator descriptor screen appears, click Uninstall.

  5. Select Also completely remove the Operator from the selected namespace, in the Remove Operator Subscription dialog box.

  6. Click Remove.