Introduction

Each project’s git repository structure has a top-level file called Jenkinsfile which is utilized by the continuous integration process to enable each project to specify certain additional build steps.

The library primarily supports two types of development environments at this time – Java-based Maven projects and Nodejs-based projects.

The files and main parameters are explained below for back-end and front-end modules.

Each parameter can be omitted to accept the default.

The values are: true or false (or the old syntax 'yes' or 'no').

Back-end modules

A typical Maven-based, server-side FOLIO module Jenkinsfile configuration might look like the following. See an example at mod-courses/Jenkinsfile

buildMvn {
  buildNode = 'jenkins-agent-java17'
  publishModDescriptor = true
  mvnDeploy = true

  doDocker = {
    buildJavaDocker {
      publishMaster = true
      healthChk = true
      healthChkCmd = 'wget --no-verbose --tries=1 --spider http://localhost:8081/admin/health || exit 1'
    }
  }
}

• buildNode – The Jenkins node to run the CI build. The default is 'jenkins-agent-java11' if not specified. The other available option is 'jenkins-agent-java17'.

• publishModDescriptor – Maven-based modules will generate the ModuleDescriptor.json file as explained. It will be published to the FOLIO Module Descriptor registry. (Default: false)

• mvnDeploy – Deploy Maven artifacts to FOLIO Maven repository. (Default: false)

• doUploadApidocs – If the module also generates API documentation during its CI Maven phase, then upload to S3. Uploads all generated docs found in the “target/apidocs” directory. (Note: This is additional to “api-doc”.) More explanation at FOLIO-3008. Example: mod-search. (Default: false)

If we are creating and deploying a Docker image as part of the module’s artifacts, specify ‘doDocker’ with ‘buildJavaDocker’ (for Spring-based modules instead use the ‘buildDocker’) and the following options:

• publishMaster – Publish image to ‘folioci’ Docker repository on Docker Hub when building ‘master’ branch. (Default: true)

• healthChk – Perform a container healthcheck during build. See ‘healthChkCmd’. (Default: false)

• healthChkCmd – Use the specified command to perform container health check. The command is run inside the container and typically tests a REST endpoint to determine the health of the application running inside the container. Prefer wget over curl as Alpine by default ships without curl but with BusyBox, a multi-call binary that contains wget with reduced number of options.

Front-end modules

A typical Stripes or UI module Jenkinsfile configuration might look like the following. See an example at ui-orders/Jenkinsfile.

(Note: Front-end modules are gradually being migrated to use GitHub Actions Workflows. So for those, Jenkinsfile is not relevant.)

buildNPM {
  buildNode = 'jenkins-agent-java11'
  publishModDescriptor = true
  runLint = true
  runTest = true
  runTestOptions = '--karma.singleRun --karma.browsers=ChromeDocker'
  runRegression = 'partial'
}

• buildNode – The Jenkins node to run the CI build. The default is 'jenkins-agent-java11' if not specified (this utlises Node.js v14). The other available option is 'jenkins-agent-java17' (this utlises Node.js LTS v16). Of course the CI does not use Java for front-end modules, but that is the naming convention for the build nodes.

• publishModDescriptor – If a FOLIO Module Descriptor is defined in its package.json then the ModuleDescriptor.json will be generated and published to the FOLIO Module Descriptor registry. (Default: false)

• runLint – Execute ‘yarn lint’ as part of the build. Ensure a ‘lint’ run script is defined in package.json before enabling this option. (Default: false)

• runTest – Execute ‘yarn test’ as part of the build. Ensure a ‘test’ run script is defined in package.json. ‘test’ is typically used for unit tests. (Default: false)

• runTestOptions – Provide ‘yarn test’ with additional options. The example shows options for karma-based testing.

• sonarScanDirs – List of directories (comma-separated string) that the Sonarqube scanner should scan. (Default: ‘./src’)

• runRegression – Execute the UI regression test suite from ‘ui-testing’ against a real FOLIO backend. Option ‘full’ will execute the full test suite. Option ‘partial’ will execute only tests specific to the UI module. Option ‘none’ will disable regression testing. (Default: ‘none’)

• stripesPlatform – Specify which Stripes platform. (Default: ‘none’, so build in “app” context.)

Further information

There are other options available to ‘buildNPM’, ‘buildMvn’, and ‘buildJavaDocker’ for certain corner cases. Please ask for assistance.