Chapter 5. Pipelines CLI (tkn)

Example: Display all options

$ tkn

Example: Completion code for bash shell

$ tkn completion bash

Example: Check the tkn version

$ tkn version

Example: Display help

$ tkn pipeline --help

Example: Delete the mypipeline pipeline from a namespace

$ tkn pipeline delete mypipeline -n myspace

Example: Describe the mypipeline pipeline

$ tkn pipeline describe mypipeline

Example: Display a list of pipelines

$ tkn pipeline list

Example: Stream the live logs for the mypipeline pipeline

$ tkn pipeline logs -f mypipeline

Example: Start the mypipeline pipeline

$ tkn pipeline start mypipeline

Example: Display help

$ tkn pipelinerun -h

Example: Cancel the mypipelinerun pipeline run from a namespace

$ tkn pipelinerun cancel mypipelinerun -n myspace

Example: Delete pipeline runs from a namespace

$ tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace

Example: Delete all pipeline runs from a namespace, except the five most recently executed pipeline runs

$ tkn pipelinerun delete -n myspace --keep 5 

Example: Delete all pipelines

$ tkn pipelinerun delete --all

Example: Describe the mypipelinerun pipeline run in a namespace

$ tkn pipelinerun describe mypipelinerun -n myspace

Example: Display a list of pipeline runs in a namespace

$ tkn pipelinerun list -n myspace

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

$ tkn pipelinerun logs mypipelinerun -a -n myspace

Example: Display help

$ tkn task -h

Example: Delete mytask1 and mytask2 tasks from a namespace

$ tkn task delete mytask1 mytask2 -n myspace

Example: Describe the mytask task in a namespace

$ tkn task describe mytask -n myspace

Example: List all the tasks in a namespace

$ tkn task list -n myspace

Example: Display logs for the mytaskrun task run of the mytask task

$ tkn task logs mytask mytaskrun -n myspace

Example: Start the mytask task in a namespace

$ tkn task start mytask -s <ServiceAccountName> -n myspace

Example: Display help

$ tkn taskrun -h

Example: Cancel the mytaskrun task run from a namespace

$ tkn taskrun cancel mytaskrun -n myspace

Example: Delete the mytaskrun1 and mytaskrun2 task runs from a namespace

$ tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace

Example: Delete all but the five most recently executed task runs from a namespace

$ tkn taskrun delete -n myspace --keep 5 

Example: Describe the mytaskrun task run in a namespace

$ tkn taskrun describe mytaskrun -n myspace

Example: List all the task runs in a namespace

$ tkn taskrun list -n myspace

Example: Display live logs for the mytaskrun task run in a namespace

$ tkn taskrun logs -f mytaskrun -n myspace

Example: Display help

$ tkn condition --help

Example: Delete the mycondition1 Condition from a namespace

$ tkn condition delete mycondition1 -n myspace

Example: Describe the mycondition1 Condition in a namespace

$ tkn condition describe mycondition1 -n myspace

Example: List Conditions in a namespace

$ tkn condition list -n myspace

Example: Display help

$ tkn resource -h

Example: Create a Pipeline Resource in a namespace

$ tkn resource create -n myspace

Example: Delete the myresource Pipeline Resource from a namespace

$ tkn resource delete myresource -n myspace

Example: Describe the myresource Pipeline Resource

$ tkn resource describe myresource -n myspace

Example: List all Pipeline Resources in a namespace

$ tkn resource list -n myspace

Example: Display help

$ tkn clustertask --help

Example: Delete mytask1 and mytask2 ClusterTasks

$ tkn clustertask delete mytask1 mytask2

Example: Describe the mytask ClusterTask

$ tkn clustertask describe mytask1

Example: List ClusterTasks

$ tkn clustertask list

Example: Start the mytask ClusterTask

$ tkn clustertask start mytask

Example: Display help

$ tkn eventlistener -h

Example: Delete mylistener1 and mylistener2 EventListeners in a namespace

$ tkn eventlistener delete mylistener1 mylistener2 -n myspace

Example: Describe the mylistener EventListener in a namespace

$ tkn eventlistener describe mylistener -n myspace

Example: List all the EventListeners in a namespace

$ tkn eventlistener list -n myspace

Example: Display the logs of the mylistener EventListener in a namespace

$ tkn eventlistener logs mylistener -n myspace

Example: Display TriggerBindings help

$ tkn triggerbinding -h

Example: Delete mybinding1 and mybinding2 TriggerBindings in a namespace

$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace

Example: Describe the mybinding TriggerBinding in a namespace

$ tkn triggerbinding describe mybinding -n myspace

Example: List all the TriggerBindings in a namespace

$ tkn triggerbinding list -n myspace

Example: Display TriggerTemplate help

$ tkn triggertemplate -h

Example: Delete mytemplate1 and mytemplate2 TriggerTemplates in a namespace

$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`

Example: Describe the mytemplate TriggerTemplate in a namespace

$ tkn triggertemplate describe mytemplate -n `myspace`

Example: List all the TriggerTemplates in a namespace

$ tkn triggertemplate list -n myspace

Example: Display ClusterTriggerBindings help

$ tkn clustertriggerbinding -h

Example: Delete myclusterbinding1 and myclusterbinding2 ClusterTriggerBindings

$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2

Example: Describe the myclusterbinding ClusterTriggerBinding

$ tkn clustertriggerbinding describe myclusterbinding

Example: List all ClusterTriggerBindings

$ tkn clustertriggerbinding list

Example: Display help

$ tkn hub -h

Example: Interact with a hub API server

$ tkn hub --api-server https://api.hub.tekton.dev

Example: Downgrade the mytask task in the mynamespace namespace to it’s older version

$ tkn hub downgrade task mytask --to version -n mynamespace

Example: Get the manifest for a specific version of the myresource pipeline or task from the tekton catalog

$ tkn hub get [pipeline | task] myresource --from tekton --version version

Example: Display information about a specific version of the mytask task from the tekton catalog

$ tkn hub info task mytask --from tekton --version version

Example: Install a specific version of the mytask task from the tekton catalog in the mynamespace namespace

$ tkn hub install task mytask --from tekton --version version -n mynamespace

Example: Reinstall a specific version of the mytask task from the tekton catalog in the mynamespace namespace

$ tkn hub reinstall task mytask --from tekton --version version -n mynamespace

Example: Search a resource with a tag cli

$ tkn hub search --tags cli

Example: Upgrade the installed mytask task in the mynamespace namespace to a new version

$ tkn hub upgrade task mytask --to version -n mynamespace