Lab - Login & Tour of OpenShift

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 you can skip this lab - after making sure you can login.

Wetty Environment Links

Your instructor will assign you an OpenShift environment and login.

Please click "Return to Workshop" above to view the OpenShift Environment Links.

Key Terms

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

Accessing OpenShift

OpenShift provides a web console that allow you to perform various tasks via a web browser. Additionally, you can utilize a command line tool to perfrom tasks. Let's get started by logging into both of these and checking the status of the platform.

Let's Login

Navigate to the URI provided by your instructor and login with the user/password provided (if there's an icon on the Desktop, just double click that)

Login Webpage

Once logged in you should see your available projects.

An OpenShift project allows a community of users (or a user) to organize and manage their content in isolation from other communities. Each project has its own resources, policies (who can or cannot perform actions), and constraints (quotas and limits on resources, etc). Projects act as a "wrapper" around all the application services and endpoints you (or your teams) are using for your work.

Users must be given access to projects by administrators, or if allowed to create projects, automatically have access to their own projects.

Projects can have a separate name, displayName, and description.

A project is technically a Kubernetes namespace with additional annotations.

So this is what an empty project looks like

Click on one of the projects from the project list

Don't worry, it's supposed to look empty right now because you currently don't have anything in your project. We'll fix that in the next lab.

If you do not see an available project, go ahead and click New Project and create one.

Let's try the command line

Open a terminal and login using the same URI/user/password with following command:

$ oc login [URI] --insecure-skip-tls-verify=true

See example below:

$ oc login https://<workshopname> --insecure-skip-tls-verify=true

Check to see what projects you have access to:

$ oc get projects

It looks empty via the command line too

Type the following command to use the demo project (replace 'demo' with the project you want to use if there isn't a demo project):

$ oc new-project demo

You may recieve the message "Error from server: project "demo" already exists". Try another project name i.e. your first initial and lastname.

If you create more than one project, then you can switch projects with the following command:

$ oc project [NAME]

Help about any command

To see the full list of commands supported, run oc help.

Type the following command to read more information about services, deployment configs, build configurations, and active deployments:

$ oc status -h


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

Return to Workshop