Lab 1 - Welcome

Return to Workshop

Welcome to OpenShift!

This lab provides a quick tour of the console to help you get familiar with the user interface along with some key terminology we will use in subsequent lab content. If you are already familiar with the basics of OpenShift simply ensure you can login and create the project.

Key Terms

We will be using the following terms throughout the workshop labs so here are some basic definitions you should be familiar with. You’ll learn more terms along the way, but these are the basics to get you started.

Accessing OpenShift through the Web Console

OpenShift provides a web console that allows you to perform various tasks via a web browser.

Let’s Login to the Web Console

Use your browser to navigate to the URI provided by your instructor and login with the user/password provided.

https://console-openshift-console.apps.example.redhatgov.io


Login Webpage

Once you are logged in you should see the overview page for your cluster:


Administrator Default View

This is what an empty project looks like

First, let’s create a new project to run a terminal application that we’ll use for the rest of the workshop.

Click on “Projects” then the “Create Project” button and give it a name of terminal

Populate “Name” with “terminal” and populate the “Display Name” and “Description” boxes with whatever you like. Click on “Create” to create the project.



This is going to take you to the next logical step of adding something to the project but we don’t want to do that just yet.

Let’s deploy Butterfly (Browser-based SSH)

First, we need to change views from the “Administrator” view to the “Developer” view. There is a pop-up menu in the top left corner of the screen just below the menu (three horizontal lines) button.

Click "Administrator" and change it to "Developer"


Click "+Add" to add a new item to the project


Click "Container Image" to add an existing image from the container registry

In the dialog box under the default radio button "Image name from external registry", enter "quay.io/openshifthomeroom/workshop-terminal". The image should be "Validated" when found.

Observe the default values that are populated in the search results.

Click "Create"

You will now see a screen that shows a thumbnail view of your deployed application. Click on “D workshop-termin…” to expand the screen and see the details of the running pod:


"Topology"


Test out the Butterfly webapp

Notice that in the web console overview, you now have a URL in the service box. You can see the webapp running by clicking the exposed route.


After clicking on the URLa new browser window should open placing you into a terminal session.


Now, type the command oc.

Accessing OpenShift through the CLI

In addition to the web console we previously used, you can utilize a command line tool to perform tasks.

Using the command line (CLI)

Use your existing Butterfly terminal login following command:
$ oc login
Using the same username/password combination as before, finish authenticating to the CLI
Authentication required for https://api.example.redhatgov.io:6443 (openshift)
 Username: kubeadmin
 Password:
Login successful.
Check to see what projects you have access to:
$ oc get projects

You will see ~58 projects including the “terminal-0” project.

Use the CLI to create a new project

Use the CLI to create and use a new project by typing the following command to create and use the project "demo-0"
$ oc new-project demo-0
Type the following command to show services, deployment configs, build configurations, and active deployments (this will come in handy later):
$ oc status

Summary

You should now be ready to get hands-on with our workshop labs.


Workshop Details

Domain Red Hat Logo
Workshop
Student ID

Return to Workshop