Chapter 5. 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.

The CLI is available for Linux (32- or 64-bit), Mac OS X, and Windows. After you have downloaded the CLI, return to these steps.

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

$ echo $PATH

C:\> path

After it is installed, you can use the oc command from your command shell.

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>

The oc login command is the best way to initially set up the OpenShift Online CLI. The information is automatically saved in a CLI configuration file that is then used for subsequent commands.

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>

After creating the new project, you will be automatically switched to the new project namespace.

If you followed the Basic Walkthrough topic, you already created your first project. You must switch to your project namespace and clear out the original sample application.

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

The tool will inspect the source code, locate an appropriate image that can build the source code, create an image stream for the new application image that will be built, then create the correct build configuration, deployment configuration and service definition.

The oc new-app command kicks off a build after all required dependencies are confirmed and automatically deploys the application after the image is available.

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

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'

For example:

$ 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:

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