Beyond the Basics

On GitHub, navigate to the openshift/nodejs-ex repository. In the top-right corner of the page, click Fork:

Next, execute the following commands on your local machine to clone the sample application and change to the new directory:

$ git clone https://github.com/<your_github_username>/nodejs-ex
$ cd nodejs-ex

First, download the OpenShift Online CLI from the About page in the OpenShift Online web console.

Next, unpack or unzip the archive and move the oc binary to a directory on your PATH.

$ echo $PATH

C:\> path

Then, visit the About page in the OpenShift Online web console.

Copy the oc login command shown with your current session token to log in to OpenShift Online from the CLI:

$ oc login https://<your_cluster_ID>.openshift.com --token=<your_session_token>

First, create a new project. Replace <project_name> below with a unique name for your project, such as <your_github_username>-example:

$ oc new-project <project_name>

Next, create a new application from your forked copy of the nodejs-ex source code file:

$ oc new-app https://github.com/<your_github_username>/nodejs-ex --name nodejs-mongodb-example

First, find your service name (which should be nodejs-mongodb-example with:

$ oc get services

Next, create a route to expose your service to external requests:

$ oc expose service/nodejs-mongodb-example

Now you can find the external host/port for your service with:

$ oc get routes

Finally, copy the route HOST/PORT for your application and paste it in the browser to view your application:

Add the OpenShift Online-provided MongoDB database to your project with:

$ oc new-app mongodb-persistent \
-p MONGODB_USER=admin \
-p MONGODB_PASSWORD=secret \
-p MONGODB_ADMIN_PASSWORD=super-secret

Note the name of the MongoDB service before heading to the next section.

You must add the environment variable MONGO_URL to your Node.js web service so that it will utilize the MongoDB service, and enable the "Page view count" feature. Run:

$ oc set env dc/nodejs-mongodb-example
MONGO_URL='mongodb://admin:secret@<MongoDB-service-name>:27017/sampledb'

$ oc set env dc/nodejs-mongodb-example
MONGO_URL='mongodb://admin:secret@mongodb-persistent:27017/sampledb'

Next, run oc status to confirm that an updated deployment has been kicked off. After the deployment completes, you will now have a Node.js welcome page showing the current hit count, as stored in a MongoDB database.

$ oc set env pods --all --list

First, run the following command to display the webhook URLs associated with your build configuration:

$ oc describe buildConfig nodejs-mongodb-example

Copy the webhook GitHub URL output by the above command. The webhook URL will be in the following format:

http://<openshift_api_host:port>/osapi/v1/namespaces/<namespace>/buildconfigs/frontend/webhooks/<your_secret_key>/github

Next, navigate to your forked repository on GitHub, then:

On your local machine, use a text editor to open the sample application’s source for the file nodejs-ex/views/index.html.

Make a code change that will be visible from within your application. For example, change the title on line 219:

Commit the changes in Git, and push the change to your GitHub repository:

$ git add nodejs-ex/views/index.html
$ git commit -m "Updates heading on welcome page"
$ git push origin master

If your webhook is correctly configured, your application will immediately rebuild itself based on your changes. You can follow along on the Overview page for your project in the web console to see watch the progress of the build and deployment. View your application using a web browser to see your changes once the deployment is completed.