In this exercise, you'll deploy a simple Node.js Express application - "Example Health". Example Health is a simple UI for a patient health records system. We'll use this example to demonstrate key OpenShift features throughout this workshop. You can find the sample application GitHub repository here: https://github.com/IBM/node-s2i-openshift
Access your cluster on the IBM Cloud clusters dashboard. Click the
OpenShift web console button on the top-right. (This is a pop-up so you'll need to white list this site.)
Here is the main dashboard you should see.
Create a project, on the left hand side, you can title it whatever you like, we suggest "example-health."
And fill it out something like this.
You should see a view that looks like this.
Now click on
Administrator and select
Click on the
From Catalog button.
Scroll down and select
Node.js Builder Image. If you don't see it, check
Builder Image under
You'll see an form like this:
Enter the repository:
Then click the
Show Advanced Git Options and enter
Context Dir. Click 'Create' at the bottom of the window to build and deploy the application.
Click on the center circle, then click "Start Build." You should see #1 Build start. You can click on the "View logs" to get more details.
When the build has deployed, find the "Routes." Click on that link:
And you should see the login screen like the following:
You can enter any strings for username and password, for instance
test:test because the app is running in demo mode.
Congrats! You've deployed a
Node.js app to Kubernetes using OpenShift Source-to-Image (S2I).
S2I is a framework that creates container images from source code, then runs the assembled images as containers. It allows developers to build reproducible images easily, letting them spend time on what matters most, developing their code!
So far we have been doing a lot of manual deployment. In cloud-native world we want to move away from manual work and move toward automation. Wouldn't it be nice if our application rebuilt on git push events? Git webhooks are the way its done and openshift comes bundled in with git webhooks. Let's set it up for our project.
To be able to setup git webhooks, we need to have elevated permission to the project. We don't own the repo we have been using so far. But since its opensource we can easily fork it and make it our own.
Fork the repo at https://github.com/IBM/node-s2i-openshift
Now that I have forked the repo under my repo I have full admin priviledges. As you can see I now have a settings button that I can change the repo settings with.
We will come back to this page in a moment. Lets change our git source to our repo.
From our openshift dashboard for our project. Select
node-s-2-i-openshift build. As of now this should be the only build on screen.
Action on the right and then select
Edit Build Config
Git Repository URL to our forked repository, and click
You will see this will not result in a new build. If you want to start a manual build you can do so by clicking
Start Build. We will skip this for now and move on to the webhook part.
Click on the
Scroll down and click
Copy URL with Secret for the GitHub Webook URL.
The webhook is in the structure
There is also the generic webhook url. This also works for github. But the github webhook captures some additional data from github and is more specific. But if we were using some other git repo like bitbucket or gitlab we would use the generic one.
In our github repo go to
Setting > Webhooks. Then click
In the Add Webhook page fill in the
Payload URL with the url copied earlier from the build configuration. Change the
Content type to
NOTE: The Secret field can remain empty.
Right now just the push event is being sent which is fine for our use.
If the webhook is reachable by github you will see a green check mark.
Back in our Openshift Console we still would only see one build however. Because we added a webhook that sends us push events and we have no push event happening. Lets make one. The easiest way to do it is probably from the Github UI. Lets change some text in the login page.
Path to this file is
site/public/login.html from the root of the directory. On Github you can edit any file by clicking the Pencil icon on the top right corner.
Let's change the name our application to
Demo Health (Line 21, Line 22). Feel free to make any other UI changes you feel like.
Once done go to the bottom and click
Go to the Openshift Console and click on the
Builds tab. This happens quite fast so you might not see the running state. But the moment we made that commit a new build was kicked off.
In a moment it will show completed. Navigate to the
Topology -> Application to find the route.
You could also go to
Applications > Routesto find the route for the application.
If you go to your new route you will see your change.