sourcemation/helidon repository overview

⁠Helidon packaged by Sourcemation

Helidon is a release of libraries for the Java programming language for writing microservices. This container image provides the essential development environment for Helidon applications. It is based on Rocky Linux 9 and includes the following tools:

• Java 21 with development packages
• Java 21 jmods
• Maven 3.8 from the official (provided by the Rocky Linux 9 packaging team) maven:3.8 dnf module
• Helidon CLI 4.10.0

The jmods double the image size, but are necessary for jlink custom runtime creation.

Lastly, the image runs the helidon non-root user by default for security reasons.

⁠Usage

Example usage with creating a new Helidon project.

Firstly, run the container:

$ docker run --name helidon-dev-env --rm -it sourcemation/helidon:latest

Having a shell in this container, create and start your Helidon project:

$ helidon --version # returns version build date etc
$ helidon init --name my-helidon-project --package com.example --batch
$ cd my-helidon-project
$ helidon dev

Now you can access the application at http://localhost:8080/ with the http://localhost:8080/simple-greet endpoint enabled (from the inside of the container).

You can additionally customize your experience by mounting volumes to the container, using it with your IDE, and exposing ports to the host machine. For example:

$ podman run --name helidon-dev-env --rm -it -v $(pwd):/helidon/my-helidon-project -p 8080:8080 sourcemation/helidon:latest

⁠Environment Vars, Ports, Volumes

This image uses the following environment variables:

PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
JAVA_HOME="/usr/lib/jvm/java-21"

By default, the image exposes the following ports:

• 8080 - Default development port for Helidon development

⁠Contributing and Reporting Issues

Your contributions are valued! Feel free to suggest enhancements or request new images by opening an issue, or submit your own contributions via pull requests to the Sourcemation GitHub repository.

• Creating issues (bugs) and images requests⁠
• Creating pull requests⁠

Disclaimer: The sourcemation/helidon image is not affiliated with Oracle, Inc. The respective companies and organisations own the trademarks mentioned in the offering. The sourcemation/helidon image is a separate project and is maintained by Sourcemation⁠.

⁠Extra notes

⁠Image and its components Risk Analysis report

A detailed risk analysis report of the image and its components can be found on the Sourcemation platform.

For more information, check out the Getting started with Helidon CLI⁠ page.

⁠Licenses

The base license for the solution (Helidon) is the Apache License, Version 2.0⁠. The licenses for each component shipped as part of this image can be found on the image's appropriate Sourcemation entry.