Difficulty: beginner
Estimated Time: 10-15 minutes

When using OpenShift there are a number of different ways you can add an application. The main methods are:

  • Deploy an application from an existing container image.
  • Build and deploy from source code contained in a Git repository using a Source-to-Image builder.
  • Build and deploy from source code contained in a Git repository from a Dockerfile.

In this course you will learn how to deploy an application from an existing container image using the OpenShift web console, and from the command line using oc.

In this course you learnt about deploying an existing container image to OpenShift.

You can find a summary of the key commands covered below. To see more information on each oc command, run it with the --help option.

oc new-app <docker-image> --name <name>: Deploy an application from a container image found on an external image registry. If there is any ambiguity as to the source of the image, use the --docker-image option.

Deploying Applications From Images

Step 1 of 5

Topic 1 - Creating an Initial Project

Before we get started, you need to login and create a project in OpenShift to work in.

To login to the OpenShift cluster used for this course from the Terminal, run:

oc login -u developer -p developer

This will log you in using the credentials:

  • Username: developer
  • Password: developer

You should see the output:

Login successful.

You don't have any projects. You can try to create a new project, by running

    oc new-project <projectname>

To create a new project called myproject run the command:

oc new-project myproject

You should see output similar to:

Now using project "myproject" on server "https://openshift:6443".

You can add applications to this project with the 'new-app' command. For example, try:

    oc new-app django-psql-example

to build a new example application in Python. Or use kubectl to deploy a simple Kubernetes application:

    kubectl create deployment hello-node --image=gcr.io/hello-minikube-zero-install/hello-node

Switch to the Console and login to the OpenShift web console using the same credentials you used above.

Web Console Login

This should leave you at the list of projects you have access to. As we only created the one project, all you should see is myproject.

List of Projects

Click on myproject and you should then be at the Overview page for the project. Select the Developer perspective for the project instead of the Adminstrator perspective in the left hand side menu. If necessary click on the hamburger menu icon top left of the web console to expose the left hand side menu.

As the project is currently empty, no workloads should be found and you will be presented with various options for how you can deploy an application.

Add to Project