Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 6. Pipelines CLI (tkn)

6.1. Installing tkn

Use the tkn CLI to manage Red Hat OpenShift Pipelines from a terminal. The following section describes how to install tkn on different platforms.

You can also find the URL to the latest binaries from the OpenShift Container Platform web console by clicking the ? icon in the upper-right corner and selecting Command Line Tools.

6.1.1. Installing Red Hat OpenShift Pipelines CLI (tkn) on Linux

For Linux distributions, you can download the CLI directly as a tar.gz archive.

Procedure

  1. Download the relevant CLI.

  2. Unpack the archive:

    Copy to Clipboard Toggle word wrap 
    $ tar xvzf <file>
  3. Place the tkn binary in a directory that is on your PATH.

  4. To check your PATH, run:

    Copy to Clipboard Toggle word wrap 
    $ echo $PATH

6.1.2. Installing Red Hat OpenShift Pipelines CLI (tkn) on Linux using an RPM

For Red Hat Enterprise Linux (RHEL) version 8, you can install the Red Hat OpenShift Pipelines CLI (tkn) as an RPM.

Prerequisites

  • You have an active OpenShift Container Platform subscription on your Red Hat account.
  • You have root or sudo privileges on your local system.

Procedure

  1. Register with Red Hat Subscription Manager:

    Copy to Clipboard Toggle word wrap 
    # subscription-manager register

  2. Pull the latest subscription data:

    Copy to Clipboard Toggle word wrap 
    # subscription-manager refresh

  3. List the available subscriptions:

    Copy to Clipboard Toggle word wrap 
    # subscription-manager list --available --matches '*pipelines*'

  4. In the output for the previous command, find the pool ID for your OpenShift Container Platform subscription and attach the subscription to the registered system:

    Copy to Clipboard Toggle word wrap 
    # subscription-manager attach --pool=<pool_id>

  5. Enable the repositories required by Red Hat OpenShift Pipelines:

    Copy to Clipboard Toggle word wrap 
    # subscription-manager repos --enable="pipelines-1.2-for-rhel-8-x86_64-rpms"

  6. Install the openshift-pipelines-client package:

    Copy to Clipboard Toggle word wrap 
    # yum install openshift-pipelines-client

After you install the CLI, it is available using the tkn command:

Copy to Clipboard Toggle word wrap 
$ tkn version

6.1.3. Installing Red Hat OpenShift Pipelines CLI (tkn) on Windows

For Windows, the tkn CLI is provided as a zip archive.

Procedure

  1. Download the CLI.
  2. Unzip the archive with a ZIP program.
  3. Add the location of your tkn.exe file to your PATH environment variable.

  4. To check your PATH, open the command prompt and run the command:

    Copy to Clipboard Toggle word wrap 
    C:\> path

6.1.4. Installing Red Hat OpenShift Pipelines CLI (tkn) on macOS

For macOS, the tkn CLI is provided as a tar.gz archive.

Procedure

  1. Download the CLI.
  2. Unpack and unzip the archive.
  3. Move the tkn binary to a directory on your PATH.

  4. To check your PATH, open a terminal window and run:

    Copy to Clipboard Toggle word wrap 
    $ echo $PATH

6.2. Configuring the OpenShift Pipelines tkn CLI

Configure the Red Hat OpenShift Pipelines tkn CLI to enable tab completion.

6.2.1. Enabling tab completion

After you install the tkn CLI, you can enable tab completion to automatically complete tkn commands or suggest options when you press Tab.

Prerequisites

  • You must have the tkn CLI tool installed.
  • You must have bash-completion installed on your local system.

Procedure

The following procedure enables tab completion for Bash.

  1. Save the Bash completion code to a file:

    Copy to Clipboard Toggle word wrap 
    $ tkn completion bash > tkn_bash_completion

  2. Copy the file to /etc/bash_completion.d/:

    Copy to Clipboard Toggle word wrap 
    $ sudo cp tkn_bash_completion /etc/bash_completion.d/

    Alternatively, you can save the file to a local directory and source it from your .bashrc file instead.

Tab completion is enabled when you open a new terminal.

6.3. OpenShift Pipelines tkn reference

This section lists the basic tkn CLI commands.

6.3.1. Basic syntax

tkn [command or options] [arguments…​]

6.3.2. Global options

--help, -h

6.3.3. Utility commands

6.3.3.1. tkn

Parent command for tkn CLI.

Example: Display all options

Copy to Clipboard Toggle word wrap 
$ tkn

6.3.3.2. completion [shell]

Print shell completion code which must be evaluated to provide interactive completion. Supported shells are bash and zsh.

Example: Completion code for bash shell

Copy to Clipboard Toggle word wrap 
$ tkn completion bash

6.3.3.3. version

Print version information of the tkn CLI.

Example: Check the tkn version

Copy to Clipboard Toggle word wrap 
$ tkn version

6.3.4. Pipelines management commands

6.3.4.1. pipeline

Manage Pipelines.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn pipeline --help

6.3.4.2. pipeline delete

Delete a Pipeline.

Example: Delete the mypipeline Pipeline from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipeline delete mypipeline -n myspace

6.3.4.3. pipeline describe

Describe a Pipeline.

Example: Describe mypipeline Pipeline

Copy to Clipboard Toggle word wrap 
$ tkn pipeline describe mypipeline

6.3.4.4. pipeline list

List Pipelines.

Example: Display a list of Pipelines

Copy to Clipboard Toggle word wrap 
$ tkn pipeline list

6.3.4.5. pipeline logs

Display Pipeline logs for a specific Pipeline.

Example: Stream live logs for the mypipeline Pipeline

Copy to Clipboard Toggle word wrap 
$ tkn pipeline logs -f mypipeline

6.3.4.6. pipeline start

Start a Pipeline.

Example: Start mypipeline Pipeline

Copy to Clipboard Toggle word wrap 
$ tkn pipeline start mypipeline

6.3.5. PipelineRun commands

6.3.5.1. pipelinerun

Manage PipelineRuns.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun -h

6.3.5.2. pipelinerun cancel

Cancel a PipelineRun.

Example: Cancel the mypipelinerun PipelineRun from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun cancel mypipelinerun -n myspace

6.3.5.3. pipelinerun delete

Delete a PipelineRun.

Example: Delete PipelineRuns from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace

6.3.5.4. pipelinerun describe

Describe a PipelineRun.

Example: Describe the mypipelinerun PipelineRun in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun describe mypipelinerun -n myspace

6.3.5.5. pipelinerun list

List PipelineRuns.

Example: Display a list of PipelineRuns in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun list -n myspace

6.3.5.6. pipelinerun logs

Display the logs of a PipelineRun.

Example: Display the logs of the mypipelinerun PipelineRun with all tasks and steps in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn pipelinerun logs mypipelinerun -a -n myspace

6.3.6. Task management commands

6.3.6.1. task

Manage Tasks.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn task -h

6.3.6.2. task delete

Delete a Task.

Example: Delete mytask1 and mytask2 Tasks from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn task delete mytask1 mytask2 -n myspace

6.3.6.3. task describe

Describe a Task.

Example: Describe the mytask Task in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn task describe mytask -n myspace

6.3.6.4. task list

List Tasks.

Example: List all the Tasks in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn task list -n myspace

6.3.6.5. task logs

Display Task logs.

Example: Display logs for the mytaskrun TaskRun of the mytask Task

Copy to Clipboard Toggle word wrap 
$ tkn task logs mytask mytaskrun -n myspace

6.3.6.6. task start

Start a Task.

Example: Start the mytask Task in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn task start mytask -s <ServiceAccountName> -n myspace

6.3.7. TaskRun commands

6.3.7.1. taskrun

Manage TaskRuns.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn taskrun -h

6.3.7.2. taskrun cancel

Cancel a TaskRun.

Example: Cancel the mytaskrun TaskRun from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn taskrun cancel mytaskrun -n myspace

6.3.7.3. taskrun delete

Delete a TaskRun.

Example: Delete mytaskrun1 and mytaskrun2 TaskRuns from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace

6.3.7.4. taskrun describe

Describe a TaskRun.

Example: Describe the mytaskrun TaskRun in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn taskrun describe mytaskrun -n myspace

6.3.7.5. taskrun list

List TaskRuns.

Example: List all TaskRuns in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn taskrun list -n myspace

6.3.7.6. taskrun logs

Display TaskRun logs.

Example: Display live logs for the mytaskrun TaskRun in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn taskrun logs -f mytaskrun -n myspace

6.3.8. Condition management commands

6.3.8.1. condition

Manage Conditions.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn condition --help

6.3.8.2. condition delete

Delete a Condition.

Example: Delete the mycondition1 Condition from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn condition delete mycondition1 -n myspace

6.3.8.3. condition describe

Describe a Condition.

Example: Describe the mycondition1 Condition in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn condition describe mycondition1 -n myspace

6.3.8.4. condition list

List Conditions.

Example: List Conditions in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn condition list -n myspace

6.3.9. Pipeline Resource management commands

6.3.9.1. resource

Manage Pipeline Resources.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn resource -h

6.3.9.2. resource create

Create a Pipeline Resource.

Example: Create a Pipeline Resource in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn resource create -n myspace

This is an interactive command that asks for input on the name of the Resource, type of the Resource, and the values based on the type of the Resource.

6.3.9.3. resource delete

Delete a Pipeline Resource.

Example: Delete the myresource Pipeline Resource from a namespace

Copy to Clipboard Toggle word wrap 
$ tkn resource delete myresource -n myspace

6.3.9.4. resource describe

Describe a Pipeline Resource.

Example: Describe the myresource Pipeline Resource

Copy to Clipboard Toggle word wrap 
$ tkn resource describe myresource -n myspace

6.3.9.5. resource list

List Pipeline Resources.

Example: List all Pipeline Resources in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn resource list -n myspace

6.3.10. ClusterTask management commands

6.3.10.1. clustertask

Manage ClusterTasks.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn clustertask --help

6.3.10.2. clustertask delete

Delete a ClusterTask resource in a cluster.

Example: Delete mytask1 and mytask2 ClusterTasks

Copy to Clipboard Toggle word wrap 
$ tkn clustertask delete mytask1 mytask2

6.3.10.3. clustertask describe

Describe a ClusterTask.

Example: Describe the mytask ClusterTask

Copy to Clipboard Toggle word wrap 
$ tkn clustertask describe mytask1

6.3.10.4. clustertask list

List ClusterTasks.

Example: List ClusterTasks

Copy to Clipboard Toggle word wrap 
$ tkn clustertask list

6.3.10.5. clustertask start

Start ClusterTasks.

Example: Start the mytask ClusterTask

Copy to Clipboard Toggle word wrap 
$ tkn clustertask start mytask

6.3.11. Trigger management commands

6.3.11.1. eventlistener

Manage EventListeners.

Example: Display help

Copy to Clipboard Toggle word wrap 
$ tkn eventlistener -h

6.3.11.2. eventlistener delete

Delete an EventListener.

Example: Delete mylistener1 and mylistener2 EventListeners in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn eventlistener delete mylistener1 mylistener2 -n myspace

6.3.11.3. eventlistener describe

Describe an EventListener.

Example: Describe the mylistener EventListener in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn eventlistener describe mylistener -n myspace

6.3.11.4. eventlistener list

List EventListeners.

Example: List all the EventListeners in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn eventlistener list -n myspace

6.3.11.5. triggerbinding

Manage TriggerBindings.

Example: Display TriggerBindings help

Copy to Clipboard Toggle word wrap 
$ tkn triggerbinding -h

6.3.11.6. triggerbinding delete

Delete a TriggerBinding.

Example: Delete mybinding1 and mybinding2 TriggerBindings in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace

6.3.11.7. triggerbinding describe

Describe a TriggerBinding.

Example: Describe the mybinding TriggerBinding in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggerbinding describe mybinding -n myspace

6.3.11.8. triggerbinding list

List TriggerBindings.

Example: List all the TriggerBindings in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggerbinding list -n myspace

6.3.11.9. triggertemplate

Manage TriggerTemplates.

Example: Display TriggerTemplate help

Copy to Clipboard Toggle word wrap 
$ tkn triggertemplate -h

6.3.11.10. triggertemplate delete

Delete a TriggerTemplate.

Example: Delete mytemplate1 and mytemplate2 TriggerTemplates in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`

6.3.11.11. triggertemplate describe

Describe a TriggerTemplate.

Example: Describe the mytemplate TriggerTemplate in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggertemplate describe mytemplate -n `myspace`

6.3.11.12. triggertemplate list

List TriggerTemplates.

Example: List all the TriggerTemplates in a namespace

Copy to Clipboard Toggle word wrap 
$ tkn triggertemplate list -n myspace

6.3.11.13. clustertriggerbinding

Manage ClusterTriggerBindings.

Example: Display ClusterTriggerBindings help

Copy to Clipboard Toggle word wrap 
$ tkn clustertriggerbinding -h

6.3.11.14. clustertriggerbinding delete

Delete a ClusterTriggerBinding.

Example: Delete myclusterbinding1 and myclusterbinding2 ClusterTriggerBindings

Copy to Clipboard Toggle word wrap 
$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2

6.3.11.15. clustertriggerbinding describe

Describe a ClusterTriggerBinding.

Example: Describe the myclusterbinding ClusterTriggerBinding

Copy to Clipboard Toggle word wrap 
$ tkn clustertriggerbinding describe myclusterbinding

6.3.11.16. clustertriggerbinding list

List ClusterTriggerBindings.

Example: List all ClusterTriggerBindings

Copy to Clipboard Toggle word wrap 
$ tkn clustertriggerbinding list

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.