Appendix C. Configuring a Jenkins freestyle project to deploy your Node.js application with nodeshift

Procedure

1. Create a new OpenShift project for your application:

   1. Open the OpenShift Web console and log in.
   2. Click Create Project to create a new OpenShift project.
   3. Enter the project information and click Create.

2. Ensure Jenkins has access to that project.

   For example, if you configured a service account for Jenkins, ensure that account has edit access to the project of your application.

3. Create a new freestyle Jenkins project on your Jenkins server:

   1. Click New Item.
   2. Enter a name, choose Freestyle project, and click OK.
   3. Under Source Code Management, choose Git and add the GitHub url of your application.
   4. Under Build Environment, make sure Provide Node & npm bin/ folder to PATH is checked and the Node.js environment is configured.
   5. Under Build, choose Add build step and select Execute Shell.

   6. Add the following to the Command area:

      npm install -g nodeshift
      nodeshift --dockerImage=registry.access.redhat.com/rhscl/ubi8/nodejs-12 --namespace=MY_PROJECT

      Substitute MY_PROJECT with the name of the OpenShift project for your application.

   7. Click Save.

4. Click Build Now from the main page of the Jenkins project to verify your application builds and deploys to the OpenShift project for your application.

   You can also verify that your application is deployed by opening the route in the OpenShift project of the application.