Tekton Dashboard is a general purpose, web-based UI for Tekton Pipelines. It allows users to manage and view Tekton Pipeline and Task runs and the resources involved in their creation, execution, and completion.

Tekton Pipelines 0.5 or later must be installed in order to use the Tekton Dashboard. Instructions to install Tekton Pipelines can be found here.

The Tekton Dashboard has a hosted image located at gcr.io/tekton-nightly/dashboard:latest To install the latest dashboard using this image:

kubectl apply -f config/release/gcr-tekton-dashboard.yaml

Alternatively, the dashboard can be installed through the same GitHub release asset:

curl -L https://github.com/tektoncd/dashboard/releases/download/v0/gcr-tekton-dashboard.yaml | kubectl apply -f -

Development installation of the Dashboard uses ko:

sh
$ docker login
$ export KO_DOCKER_REPO=docker.io/<mydockername>
$ ./install-dev.sh

The install-dev.sh script will build and push an image of the Tekton Dashboard to the Docker registry which you are logged into. Any Docker registry will do, but in this case it will push to Dockerhub. It will also apply the Pipeline0 definition and task: this allows you to import Tekton resources from Git repositories. It will also build the static web content using npm scripts.

1. Install tektoncd-pipeline-operator
2. Checkout the repository
3. Install deployment config oc process -f config/templates/deploy.yaml | oc apply -f -
4. Install build config oc process -f config/templates/build.yaml | oc apply -f -
5. Wait until the pod tekton-dashboard-1 is running in the tekton-pipelines namespace

The Dashboard can be accessed by running kubectl port-forward $(kubectl get pod --namespace tekton-pipelines -l app=tekton-dashboard -o name) --namespace tekton-pipelines 9097:9097. You can access the web UI at http://localhost:9097/

The Dashboard can be accessed through its ClusterIP Service by running kubectl proxy. Assuming tekton-pipelines is the install namespace for the dashboard, you can access the web UI at localhost:8001/api/v1/namespaces/tekton-pipelines/services/tekton-dashboard:http/proxy/

We are so excited to have you!

• See CONTRIBUTING.md for an overview of our processes
• See DEVELOPMENT.md for how to get started