Step 4: Deploy to Red Hat OpenShift

Architecture

This is a quick lab that demonstrates how to deploy a public image from Docker Hub on OpenShift. As example image the 'authors' microservice from this workshop is used.

Note: Not all images from Docker Hub can be installed. For example OpenShift doesn't allow to deploy images which run under 'root'. See the OpenShift documentation for details.

Step 4.1: Launch Red Hat OpenShift Console

Open the Red Hat OpenShift Console from the IBM Cloud OpenShift dashboard:

Your OpenShift Container Platform Dashboard will open in a new window.

You may get a browser security exception when opening your Red Hat OpenShift Container Platform for the first time.

Step 4.2: Create a Project

Once you've launched your dashboard, on the left hand side, under Home, select Projects:

Next, click Create Project:

We'll call our project workshop because we are very imaginative, but you can choose any name you wish. Click Create:

Now, we see our empty Project Details page:

Now that our project is created, let's upload an image.

Step 4.3: Deploy an Image

First, let's change to the Developer Perspective. On the left hand side, pull down the Administrator dropdown menu and select Developer:

You'll notice from the Project: dropdown menu at the top of the screen that we are in the workshop project that we just created in the Administrator Perspective. Click on Container Image:

Although many times you would deploy from a private registry, we will just take a container image that we've found on Docker Hub called hello-openshift:

Click the blue magnifying glass to the right of the image name and Red Hat OpenShift will give you more information about the image you're about to deploy:

Finally, scroll to the bottom and click Create.

After a few seconds, you'll see a new icon populating in your dashboard:

Click the Open URL icon in order to hit your deployed image's endpoint:

A new browser window should pop up displaying the message:

Hello OpenShift!

If you can see this, congratulations! You've successfully deployed an image from Docker Hub and executed it from an endpoint on your own private Red Hat OpenShift cluster.

You may want to repeat these steps with another image from Docker Hub, or an image of your own creation!