Back-end Java-based modules can specify which build image to use during the Jenkins continuous integration builds.

For the few front-end modules that still use Jenkins build rather than GitHub Workflows, the buildNode provides the relevant Nodejs version.

Using Java 17

For projects that use Java 17 (as at 2024-10-10 this is the default):

• In Jenkinsfile, declare this in the “buildMvn” section:
  buildNode = 'jenkins-agent-java17'
• In Jenkinsfile, declare the mandatory module heath check endpoint via the Docker command healthChkCmd to use ‘wget’. (There is no ‘curl’ available on the base image.)
• In Dockerfile, use:
  FROM folioci/alpine-jre-openjdk17:latest
• See other notes (e.g. POM file, and dependencies, and wget example) at Wiki JDK 17 and Java 17.

Using Java 21

For projects that use Java 21:

• In Jenkinsfile, declare this in the “buildMvn” section:
  buildNode = 'jenkins-agent-java21'
• In Jenkinsfile, declare the mandatory module heath check endpoint via the Docker command healthChkCmd to use ‘wget’. (There is no ‘curl’ available on the base image.)
• In Dockerfile, use:
  FROM folioci/alpine-jre-openjdk21:latest
• See other notes (e.g. POM file, and dependencies, and wget example) at Wiki JDK 17 and Java 17.

Not using buildMvn pipeline

As some Java-based projects do not use the “buildMvn” pipeline, they can specify the agent node in their Jenkinsfile (either 'jenkins-agent-java17' or 'jenkins-agent-java21') e.g.:

agent {
  node {
    label 'jenkins-agent-java17'
  }
}

Node version for front-end

For the few front-end projects that still use Jenkins build rather than GitHub Workflows, the buildNode provides the relevant Nodejs version:

For projects that use Nodejs 18:

• In Jenkinsfile, declare this in the “buildNPM” section:
  buildNode = 'jenkins-agent-java17'

For projects that still use Nodejs 14:

• In Jenkinsfile, declare this in the “buildNPM” section:
  buildNode = 'jenkins-agent-java11'

Using deprecated Java 11

For some projects that use Java 11 (there should now not be any):

• In Jenkinsfile, declare this in the “buildMvn” section:
  buildNode = 'jenkins-agent-java11'
• In Dockerfile, use:
  FROM folioci/alpine-jre-openjdk11:latest
• Additional upgrade notes for projects based on RAML Module Builder (RMB).

Using deprecated Java 8

Note: FOLIO modules can no longer use the deprecated Java 8 facilities (FOLIO-2926).