jeffersonlab/resize repository overview

⁠resize

A Jakarta EE 10⁠ web application for resizing images via a wrapper to ImageMagick⁠, developed for use by Presenter⁠.

• Quick Start with Compose⁠
• Install⁠
• Configure⁠
• Build⁠
• Release⁠
• Deploy⁠

⁠Quick Start with Compose

1. Grab project

git clone https://github.com/JeffersonLab/resize
cd resize

1. Launch Compose⁠

docker compose up

1. Navigate to page

http://localhost:8080/resize

⁠Install

This application requires a Java 17+ JVM and standard library to run, plus a Jakarta EE 10 application server (developed with Wildfly).

1. Install ImageMagick
2. Download Wildfly 37.0.1⁠
3. Configure⁠ Wildfly and start it
4. Download resize.war⁠ and deploy it to Wildfly
5. Navigate your web browser to localhost:8080/resize⁠

⁠Configure

⁠Runtime

Set the path to ImageMagick mogrify executable via MOGRIFY environment variable.

⁠Build

This project is built with Java 21⁠ (compiled to Java 17 bytecode), and uses the Gradle 9⁠ build tool to automatically download dependencies and build the project from source:

git clone https://github.com/JeffersonLab/resize
cd resize
gradlew build

Note: If you do not already have Gradle installed, it will be installed automatically by the wrapper script included in the source

Note for JLab On-Site Users: Jefferson Lab has an intercepting proxy⁠

⁠Release

1. Bump the version number in the VERSION file and commit and push to GitHub (using Semantic Versioning⁠).
2. The CD⁠ GitHub Action should run automatically invoking:
   • The Create release⁠ GitHub Action to tag the source and create release notes summarizing any pull requests. Edit the release notes to add any missing details. A war file artifact is attached to the release.

⁠Deploy

At JLab this app is found internally at wildfly5.acc.jlab.org/resize⁠ and at wildflytest5.acc.jlab.org/resize⁠. The ace.jlab.org and acctest.acc.jlab.org proxy servers do not proxy this internal only service. A deploy script⁠ is provided to automate wget and deploy. Example:

/opt/wildfly/cd/deploy.sh resize v1.2.3

JLab Internal Docs: RHEL9 Wildfly⁠