Getting Started with Pipelines

Create and run your first Tekton pipeline

This tutorial shows you how to:

  • Create two tasks.
  • Create a pipeline containing your tasks.
  • Use PipelineRun to instantiate and run the pipeline containing your tasks.

For this tutorial we are going to use minikube to run the commands locally.

Prerequisites

Creating and running a second task

You already have a Hello World! task. To create a second Goodbye World! task:

  1. Create a new file named goodbye-world.yaml and add the following content:

    apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: goodbye
spec:
  steps:
    - name: goodbye
      image: ubuntu
      script: |
        #!/bin/bash
        echo "Goodbye World!"

  2. Apply your task file:

    kubectl apply --filename goodbye-world.yaml

When a task is part of a pipeline you don’t have to instantiate it, the pipeline is going to take care of that.

Creating and running a pipeline

A pipeline defines an ordered series of tasks arranged in a specific execution order as part of your CI/CD workflow.

In this section you are going to create your first pipeline, that will include both the Hello World! and Goodbye World! tasks.

  1. Create a new file named hello-goodbye-pipeline.yaml and add the following content:

    apiVersion: tekton.dev/v1beta1
kind: Pipeline
metadata:
  name: hello-goodbye
spec:
  tasks:
    - name: hello
      taskRef:
        name: hello
    - name: goodbye
      runAfter:
        - hello
      taskRef:
        name: goodbye

  2. Apply your pipeline configuration to your cluster:

    kubectl apply --filename hello-goodbye-pipeline.yaml

  3. Instantiate your pipeline with a PipelineRun object. Create a new file named hello-goodbye-pipeline-run.yaml with the following content:

    apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
  name: hello-goodbye-run
spec:
  pipelineRef:
    name: hello-goodbye

  4. Start your pipeline by applying the PipelineRun configuration to your cluster:

    kubectl apply --filename hello-goodbye-pipeline-run.yaml

    You see the following output:

    pipelinerun.tekton.dev/hello-goodbye-run created

    Tekton now starts running your pipeline.

  5. To see the logs of the PipelineRun, use the following command:

    tkn pipelinerun logs hello-goodbye-run -f -n default

    The output shows both Tasks completed successfully:

    [hello : hello] Hello World!

[goodbye : goodbye] Goodbye World!

Cleanup

To delete the cluster that you created for this quickstart run:

minikube delete

The output confirms that your cluster was deleted:

🔥  Deleting "minikube" in docker ...
🔥  Deleting container "minikube" ...
🔥  Removing /home/user/.minikube/machines/minikube ...
💀  Removed all traces of the "minikube" cluster.

Further reading

Other useful resources


Last modified September 23, 2021: Crete a quickstart to run your first tekton pipeline (d420395)