Difficulty: Beginner
Estimated Time: 30

Introduction to the Tekton Dashboard

In this tutorial, we will go through:

  • Installing the Tekton Dashboard
  • Importing a Tekton Pipeline using the Tekton Dashboard
  • Creating a PipelineResource using the Tekton Dashboard
  • Creating a PipelineRun using the Tekton Dashboard
  • Monitoring the logs of a PipelineRun using the Tekton Dashboard

Additional resources

Learn more about the Tekton Dashboard

https://github.com/tektoncd/dashboard

Learn more about Tekton Pipelines

https://github.com/tektoncd/pipeline

Get involved in the Tekton Community

https://github.com/tektoncd/community#want-to-get-involved

Tekton Dashboard

Step 1 of 5

Install the Tekton Dashboard

In this section, we will install and expose the Tekton Dashboard.

Katacoda Kubernetes Cluster

It might take a minute or two for Katacoda to initialize your Kubernetes cluster. When your cluster has been initialized, the kubectl cluster-info command will return the cluster info.

Now, let's begin!

Install the Tekton Dashboard Prerequisites

  • Tekton Pipelines kubectl apply --filename https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.10.1/release.yaml
  • Tekton Triggers (optional) kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/previous/v0.3.1/release.yaml

Verify the pods are running: kubectl get pods -n tekton-pipelines

Install the Tekton Dashboard

For reference, the installation instructions are here. To install the Tekton Dashboard, run the following command: kubectl apply --filename https://storage.googleapis.com/tekton-releases/dashboard/previous/v0.5.3/tekton-dashboard-release.yaml

Verify the Dashboard pod is running: kubectl get pods -n tekton-pipelines

Expose the Tekton Dashboard

Install Ingress controller

Install the nginx ingress controller into the ingress-nginx namespace:

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/static/provider/cloud/deploy.yaml

Verify the ingress controller pod is running:

kubectl get pods -n ingress-nginx

Create Ingress for the Tekton Dashboard

View the Tekton Dashboard Service: kubectl get svc tekton-dashboard -n tekton-pipelines

The Tekton Dashboard Service is exposed on port 9097. So, create an Ingress for the tekton-dashboard Service on port 9097:

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: tekton-dashboard
  namespace: tekton-pipelines
spec:
  backend:
    serviceName: tekton-dashboard
    servicePort: 9097
EOF

Verify the Ingress was created: kubectl get ingress -n tekton-pipelines

Open the Tekton Dashboard

Open the Dashboard tab in your Katacoda window, or click on the following link: https://[[HOST_SUBDOMAIN]]-80-[[KATACODA_HOST]].environments.katacoda.com/.

It might take a minute for the ingress and Katacoda to get set up.

Dashboard homepage screenshot