Lab 3 - Deploying an App with S2I

Return to Workshop

Source to Image (S2I)

One of the useful components of OpenShift is its source-to-image capability. S2I is a framework that makes it easy to turn your source code into runnable images. The main advantage of using S2I for building reproducible docker images is the ease of use for developers. You’ll see just how simple it can be in this lab.

Let’s build a node.js web server using S2I

We can do this either via the command line or the web console. You decide which you’d rather do and follow the steps below.

$ oc new-app --name=dc-metro-map --context-dir=dc-metro-map
$ oc expose service dc-metro-map

When using the CLI, OpenShift automatically detects the source code type and select the nodejs builder image.

Check out the build details

We can see the details of what the S2I builder did. This can be helpful to diagnose issues if builds are failing.

TIP: For a node.js app, running “npm shrinkwrap” is a good practice to perform on your branch before releasing changes that you plan to build/deploy as an image with S2I

$ oc get builds
$ oc logs builds/[BUILD_NAME]

The console will print out the full log for your build. Note, you could pipe this to more or less for easier viewing in the CLI.

You should see a log output similar to the one below:

See the app in action

Let’s see this app in action!

The app should look like this in your web browser:

Clicking the checkboxes will toggle on/off the individual metro stations on each colored line. A numbered icon indicates there is more than one metro station in that area and they have been consolidated - click the number or zoom in to see more.


In this lab we deployed a sample application using source to image. This process built our code and wrapped that in a docker image. It then deployed the image into our Kubernetes platform in a pod and exposed a route to allow outside web traffic to access our application. In the next lab we will look at some details of this app’s deployment and make some changes to see how Kubernetes can help to automate our development processes. More information about creating new applications can be found here.

Workshop Details

Student ID

Return to Workshop