Workshop details

Timing and schedule

Full workshop (2 - 2.5 hours)

  • Module 1: Tekton fundamentals (30 minutes)

  • Module 2: Creating Tasks and TaskRuns (35 minutes)

  • Module 3: Building your first pipeline (35 minutes)

  • Module 4: Pipeline as code (30 minutes)

  • Module 5: Monitoring and troubleshooting (20 minutes)

Abbreviated workshop (1 hour)

  • Module 1: Tekton fundamentals (30 minutes)

  • Module 2: Creating Tasks and TaskRuns (30 minutes, abbreviated)

Technical requirements

Software versions

  • Red Hat OpenShift 4.20

  • Red Hat OpenShift Pipelines 1.21

  • OpenShift CLI (oc) version 4.20

  • Tekton CLI (tkn) version 0.38 or later

  • Web browser (Chrome, Firefox, Safari, or Edge)

Environment access

Participants need access to:

  • OpenShift 4.20 multinode cluster (provided in the lab)

  • Gitea Git server (provided in the lab)

  • Web terminal accessible from the OpenShift console

Network requirements

  • Internet connectivity is required for this lab, the OpenShift environment used is cloud hosted

  • All required images and resources are pre-deployed in your lab environment

Environment setup

Pre-workshop checklist

Before starting, verify the following:

Workshop setup

  1. Before startin we need to log into the OpenShift web console to access our terminal

    1. Click the below link to open a Terminal via the OpenShift console:

    2. https://console-openshift-console.%APPS_HOSTNAME_SUFFIX%/terminal

    3. You can log in with your user if needed:

    4. Username: %OPENSHIFT_USERNAME%

    5. Password: %OPENSHIFT_PASSWORD%

  2. When logged in you might see this pop-up. Click on Skip Tour

    OpenShift Tour Pop-up

    1. If it’s the first tine you start the Terminal you will need to initialize it. In the Initialize Terminal view enter the following:

      1. Project: Create Project

      2. Project Name: tekton-workshop-%OPENSHIFT_USERNAME%

        Initialize terminal

    2. Click on start and wait for the terminal to load.

  3. Keep the Terminal tab/window with the active terminal open during the whole workshop. You will work extensively in the terminal during the excersises.

    OpenShift Terminal running

If you, anytime during the workshop, are logged out - run the below command to log in again

oc login https://api.%APPS_HOSTNAME_SUFFIX%:6443 -u %OPENSHIFT_USERNAME% -p %OPENSHIFT_PASSWORD%

If the terminal window stops responding overall(the terminal runs as a pod in your project) try to open a new instance using the link provided above Or open it from the terminal icon in the top right corner or the OpenShift console as shown below.

OpenShift open terminal

If the command does not work for CLI login, ask your facilitator for help.

Setup validation

Run these commands in the Terminal tab to verify your environment is ready:

Verify OpenShift CLI version

oc version --client

Verify Tekton CLI version

tkn version

Great, let’s dig into the real excersises on the next page in Module 1: Tekton fundamentals