nicolas
/
OpenShift-Demo-NodeJS
mirror of https://github.com/nmasse-itix/OpenShift-Demo-NodeJS.git
1
0
Fork 0
Code Issues Releases Wiki Activity
A NodeJS application to use in OpenShift
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
49 Commits
2 Branches
0 Tags
102 KiB
 
 
 
Tree: 45a62d512b
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '45a62d512b'
${ noResults }
OpenShift-Demo-NodeJS/doc/CONFIGURE_JENKINS.md

3.9 KiB
Raw Blame History

Configure Jenkins

Create a credential named npm-secret

Login to Jenkins with your OpenShift credentials and create a Jenkins credential with the following parameters :

  • Scope: global
  • Kind: Username with password
  • Username: <your NPM username>
  • Password: <your NPM password>
  • ID: npm-secret

To create a Jenkins Credentials :

  1. Login to the Jenkins admin interface
  2. In the left side menu, click Credentials, then System
  3. Click Global credentials
  4. In the left side menu, click Add Credentials
  5. Fill-in the form
  6. Click OK

Install plugins

Install the two following Jenkins plugins :

Note: the Pipeline Utility Steps plugin might already be installed. In such case, make sure the latest version is installed.

Quick reminder to install a plugin :

  1. Login to the Jenkins admin interface
  2. In the left side menu, click Manage Jenkins
  3. Click Manage Plugins
  4. Select the Available tab
  5. Search for the plugin to install
  6. Check the box next to the plugin to install
  7. Click Download now and install after restart
  8. Do not forget to check the box Restart Jenkins

Note: to update a plugin, select the Updates tab instead of the Available tab.

Create the Jenkins Pipeline

Depending if you created a JenkinsPipeline BuildConfig, OpenShift may have created a Jenkins pipeline for you. In such a case, the Jenkins Pipeline is named <namespace>/<buildconfig-name>.

So, if you installed the demo :

  • manually, you need to create the pipeline from scratch
  • automatically, you need to update the pipeline to add the following parameters

Note : As of today, OpenShift does not accept build environment variables with Jenkins pipelines. So you have to update the Jenkins pipeline created by OpenShift to add those variable. In the next version this may change as there is a pull request for this feature (see #11293 and #12323).

So, create a Jenkins Pipeline that accepts the following parameters or update the existing Jenkins Pipeline so that it accepts the following parameters :

Parameter Name Parameter Type Default Value Description
NPM_CREDENTIALS_ID String npm-secret The Jenkins Credentials ID that holds login and password to login on NPM Registry
NPM_EMAIL String <your NPM email> The email address associated with the NPM Account pointed by NPM_CREDENTIALS_ID
NPM_REGISTRY String https://registry.npmjs.org Private NPM registry to log in to (Default if not provided: https://registry.npmjs.org)
OPENSHIFT_IMAGE_STREAM String openshift-demo-nodejs The ImageStream name to use to tag the built images
OPENSHIFT_BUILD_CONFIG String openshift-demo-nodejs The BuildConfig name to use
OPENSHIFT_SERVICE String openshift-demo-nodejs The Service object to update (either green or blue)
OPENSHIFT_DEPLOYMENT_CONFIG String openshift-demo-nodejs The DeploymentConfig name to use
OPENSHIFT_BUILD_PROJECT String demo-build The OpenShift project in which builds are run
OPENSHIFT_TEST_ENVIRONMENT String demo-test The OpenShift project in which we will deploy the test version
OPENSHIFT_PROD_ENVIRONMENT String demo-prod The OpenShift project in which we will deploy the prod version
OPENSHIFT_TEST_URL String http://demo.test.app.openshift.test The App URL in the test environment (to run the integration tests)

Pick the pipeline from GIT using the option Pipeline script from SCM and the following parameters :