Setup

Prerequisite CLI tools

The following CLI tools are required for running the exercises in this tutorial. Please have them installed and configured before you get started with any of the tutorial chapters.

It is also necessary to have a compatible Java and Maven environment (at least for the s2i chapter).
Tool macOS Fedora windows

git

Download

Download

Download

oc 4.12

Download

Download

Download

argocd v2.3.17

Download

Download

Download

yq 4.19.1

Download

Download

Download

jq v1.6.0

Download

Download

Download

Which Terminal

Throughout the lab you will have to run commands in a terminal, you can choose to run everything in your computer or in a web-terminal and web-ide. Whichever decision is fine but you have to honor that decision for the whole lab or redo some commands if you change, in this case…​ you will be on your own.

If you choose to use web-terminal, stick to that decision throughout the whole guide.

Next, open the following link, create a new project called: terminal-%USERNAME% and click on Start. If credentials are required use these:

  • USERNAME: %USERNAME%

  • PASSWORD: %PASSWORD%

https://console-openshift-console.apps.%BASE_SUBDOMAIN%/terminal

Once inside type this command to avoid the session being terminated before you have had time to finish the lab. This command could involve restarting the terminal so please run it before actually starting the lab.

wtoctl set timeout 240m

Get tutorial sources

If you prefer to use OpenShift Dev Spaces instead of your laptop (your own shell) or your browser (web-terminal) just go to the next section, otherwise:

Before we start setting up the environment, let’s clone the tutorial sources and set the TUTORIAL_HOME environment variable to point to the root directory of the tutorial:

  • laptop

  • web-terminal

export TUTORIAL_HOME="$(pwd)/kitchensink-lab"
cd $TUTORIAL_HOME
export TUTORIAL_HOME="$(pwd)/kitchensink-lab"
cd $TUTORIAL_HOME