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: Pipelines 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 details and setup

Workshop links and details

The connection details for the environment you will use are as below, come back here if you need to revisit these details:

The guide should provide the needed links timely, but if you need them you have them here too.

Pre-workshop setup

Before starting we need to log into the OpenShift web console and prepare it for the workshop.

OpenShift ships with a web-based console that will allow users to perform various tasks via a browser.

Log in to the OpenShift Web Console

Click on the 'OpenShift Console' button below

OpenShift console button to open the web console

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

    1. Username: %OPENSHIFT_USERNAME%

    2. Password: %OPENSHIFT_PASSWORD%

Open the 'OpenShift Web Terminal' by clicking the button below

OpenShift console button to open the web terminal

  1. Log in with your user if needed:

    1. Username: %OPENSHIFT_USERNAME%

    2. Password: %OPENSHIFT_PASSWORD%

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

    OpenShift welcome tour dialog with Skip Tour button highlighted

  3. If it’s the first time 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 dialog with Project Name field set to tekton-workshop-username

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

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

    OpenShift web terminal running in the bottom panel with a bash prompt

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, and pop it out to a separate window.

Terminal icon in top-right corner of the OpenShift console navigation bar

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 dive into the exercises on the next page in Module 1: Tekton fundamentals