Alauda DevOps Pipelines Docs
  • English

    • Quick Start

    This document helps new users quickly understand and install the Tekton Operator, enabling management of Tekton components in a Kubernetes cluster.

    TOC

    IntroductionApplicable ScenariosExpected Reading TimeNotesPrerequisitesOverview of the ProcessOperational StepsInstall Tekton OperatorVerify Operator InstallationInstall Tekton ComponentsVerify Component InstallationExpected ResultsNext Steps

    Introduction

    Applicable Scenarios

    This guide is suitable for users who need to deploy and manage Tekton Pipeline, Triggers, or other Tekton components on a Kubernetes cluster. Tekton Operator simplifies the installation, upgrade, and management of these components.

    Expected Reading Time

    10-15 minutes

    Notes

    • You must have cluster administrator privileges to install Tekton Operator
    • Installing Tekton components through the Operator will create resources in your cluster
    • All commands assume you have configured kubectl to connect to your cluster

    Prerequisites

    • Kubernetes cluster (version 1.21 or higher)
    • kubectl command line tool installed and configured
    • Cluster administrator permissions
    • Internet access for pulling container images

    Overview of the Process

    NumberOperational StepsDescription
    1Install Tekton OperatorDeploy the Tekton Operator in your Kubernetes cluster
    2Verify Operator InstallationConfirm that the Tekton Operator is running correctly
    3Install Tekton ComponentsUse the Operator to install Tekton Pipeline, Triggers
    4Verify Component InstallationCheck that the Tekton components are properly installed and running

    Operational Steps

    Install Tekton Operator

    The Tekton Operator allows you to install, upgrade, and manage Tekton Pipeline, and Triggers components in your Kubernetes cluster.

    1. Open the Operator Hub in Marketplace of Platform Management

    2. Search for "Alauda DevOps Pipelines" and click "Install"

    3. Select the namespace to install the Operator, e.g. tekton-operator

    4. After installation, you can see the Operator in the tekton-operator namespace

    Verify Operator Installation

    After installing the Tekton Operator, you should verify that it's running properly before proceeding.

    1. Check that the Operator pods are running:

      $ kubectl get pods -n tekton-operator

      The results should be similar to the following:

      NAME                                       READY   STATUS    RESTARTS   AGE
tekton-operator-57cfd5bb79-dnxzt           2/2     Running   0          10m
tekton-operator-webhook-6fb66bfd65-ppfz8   1/1     Running   0          10m

    2. Verify the Operator CRDs (Custom Resource Definitions) are installed:

      $ kubectl get crds | grep operator.tekton.dev

      The results should be similar to the following:

      tektonaddons.operator.tekton.dev                2025-06-20T09:47:38Z
tektonchains.operator.tekton.dev                2025-06-20T09:47:38Z
tektonconfigs.operator.tekton.dev               2025-06-20T09:47:38Z
tektondashboards.operator.tekton.dev            2025-06-20T09:47:38Z
tektonhubs.operator.tekton.dev                  2025-06-20T09:47:38Z
tektoninstallersets.operator.tekton.dev         2025-06-20T09:47:38Z
tektonpipelines.operator.tekton.dev             2025-06-20T09:47:39Z
tektonresults.operator.tekton.dev               2025-06-20T09:47:39Z
tektontriggers.operator.tekton.dev              2025-06-20T09:47:39Z
manualapprovalgates.operator.tekton.dev         2025-06-20T09:47:38Z
openshiftpipelinesascodes.operator.tekton.dev   2025-06-20T09:47:38Z

    Install Tekton Components

    The Tekton Operator uses custom resources to manage Tekton components. By default, the Operator will install Pipeline, Triggers, Chains, and Hub automatically. You can install Results, Pipelines-as-Code by creating these custom resources.

    Verify Component Installation

    After installing the Tekton components, you should verify that they are running properly.

    1. Check the TektonConfig resource:

      $ kubectl get tektonconfig config

      The results should be similar to the following:

      NAME     VERSION           READY   REASON
config   v0.74.1-fb53414   True

    2. If the TektonConfig resource is not ready, you can continue to check the TektonInstallerSet resource for details.

      kubectl get tektoninstallerset

      The results should be similar to the following:

      NAME                                READY   REASON
chain-config-5scx2                  True
chain-secret-xrq7b                  True
chain-t6wb6                         True
pipeline-main-deployment-9d9cc      True
pipeline-main-static-c7zlz          True
result-j74p5                        True
tekton-hub-api-jl9xj                True
tekton-hub-db-5g89c                 True
tekton-hub-db-migration-q7m8l       True
tekton-hub-ui-jn6bw                 True
tektoncd-pruner-fgzfh               True
trigger-main-deployment-q8zkd       True
trigger-main-static-8x5w6           True
validating-mutating-webhook-ksz2k   True

    Expected Results

    After completing all steps, the TektonConfig and TektonInstallerSet resources should be ready, you should have:

    • A running Tekton Operator in the tekton-operator namespace
    • One or more installed Tekton components (Pipeline, Triggers, Hub, Chains) in the tekton-pipelines namespace
    • Custom Resource Definitions (CRDs) for managing Tekton resources

    Next Steps

    Now that you have successfully installed the Tekton Operator and components, you can:

    1. Learn how to create and run Tekton Pipeline Tasks and Pipelines
    2. Set up Tekton Triggers for event-driven pipelines
    3. Configure advanced settings for your Tekton components using the Operator