Java Example with Gradle and Docker
Create Docker images for Spring/Gradle
Codefresh can work with Gradle builds in a similar manner as with Maven builds.
The example Gradle project
You can see the example project at https://github.com/codefresh-contrib/gradle-sample-app. The repository contains a Spring Boot 2 project built with Gradle with the following tasks:
gradle testruns unit tests
gradle buildcreates a self-container jar file (using Spring boot)
Once launched the application presents a simple message at localhost:8080 and also at the various
Gradle and Docker (multi-stage builds)
The easiest way to use Gradle is with multi-stage builds. With multi-stage builds a Docker build can use one base image for compilation/packaging/unit tests and a different one that will hold the runtime of the application. This makes the final image more secure and smaller in size (as it does not contain any development/debugging tools).
In the case of Gradle, you can use a base image that has the full JDK and gradle itself, while the final image has the JRE and nothing else.
The example project is actually using multi-stage builds by default.
Here is the multi-stage Dockerfile:
This docker build does the following:
- Starts from the gradle image
- Copies the Java source code inside the container
- Compiles the code and runs unit tests (with
- Discards the Gradle image with all the compiled classes/unit test results etc.
- Starts again from the JRE image and copies only the JAR file created before
We start Gradle without the long-running daemon, as the deamon is best used during local development only and not in CI/CD pipelines.
Create a CI pipeline for Gradle (multi-stage Docker builds)
Because in multi-stage builds Docker itself handles most of the build process, moving the project to Codefresh is straightforward. We just need a single step that creates the Docker image after checking out the code.
This will compile/test/package the Gradle application and create a Docker image. Codefresh is automatically caching Docker layers (it uses the Docker image of a previous build as a cache for the next) and therefore builds will become much faster after the first one finishes.
Packaging an existing Jar in a Docker image
It also possible to have a simpler Dockerfile that only packages the final jar which was already created in the CI/CD pipeline (i.e. outside of Docker).
A simpler Dockerfile is also provided at the same repository. It uses the base JRE image and just copies the JAR file inside the container.
This means that before building the Docker image, the compilation step (
gradle build) is expected to be finished already. Therefore in the
codefresh.yml file we need at least two steps. The first one should prepare the JAR file and the second
one should create the Docker image.
Create a CI pipeline for a Gradle JAR
The repository also contains a premade Codefresh YAML file that creates a JAR file first and then packages it in a Docker image.
Here are the full contents of the file.
After checking out the code we use the standard Gradle Docker image to run unit tests. We also pass parameters that disable the Gradle daemon, enable the build cache and also change the cache folder to reside in the Codefresh volume.
Using the Gradle cache in Codefresh
Codefresh is smart enough that caches automatically for us the workspace of a build (
/codefresh/volume). This works great for build tools that keep their cache in the project folder, but not for Maven/Gradle which keep their cache externally. By changing the location of the Gradle cache we make sure that Codefresh will cache automatically the Gradle libraries resulting in much faster builds.
The next step is similar to the previous one, but this time we actually build the JAR file. We define again a custom cache folder so when you run the build you will see that Gradle will automatically pick the cache from the previous step. All Codefresh steps in a pipeline run on the same workspace, so the build results from one step are visible to the next.
The last step is a Docker build. We name our image gradle-sample-app and tag it with a string
non-multi-stage but of course you can use any other tag name that you wish.
Once the pipeline is finished you will see the Spring Boot 2 Docker image in the Codefresh Docker registry (or any other registry that you have linked within Codefresh).