Login Tour - Butterfly

Return to Workshop

Accessing OpenShift

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.


Login Webpage

Once logged in you should see your available projects - or a button to create a project if none exist already.

So this is what an empty project looks like

First let’s create a new project to do our workshop work in. We will use the student number you were given to ensure you don’t clash with classmates, so in the steps below replace ‘YOUR#’ with your student number (if applicable).

Click on the “Create Project” button and give it a name of demo-YOUR#

Populate “Name” with “demo-YOUR# ” and populate “Description” boxes with whatever you like. And click “Create”

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.

Click the “demo-YOUR# ” link on the top left to goto your project

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).

Let’s deploy Butterfly (Browser-based SSH)

Click "Add to Project"

Select the "Deploy Image" option from the drop down

Select the option for "Image Name" and enter "quay.io/openshifthomeroom/workshop-terminal", then click the magnifying glass to the far right to search for the image.

Observe default values that are populated in the search results

Click "Deploy" then click "Close"

Does this Butterfly do anything?

Good catch, your service is running but there is no way for users to access it yet. We can fix that from the web console.


Select the arrow '>' next to 'workshop-terminal, #'

To get to this view

Notice there is no exposed route

Click on the "Create Route" link

This is where you could specify route parameters, but we will just use the defaults.

Click "Create"

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 route you just exposed.

After clicking on the URL, you should see a shell.

Now, type the command oc. We’ll explain what this tool is later in the workshop.

Workshop Details

Domain Red Hat Logo
Student ID

Return to Workshop