jrunner/readme.md at 85355efe8f7ff4a5b22335e279140aa3b8117bb1

pt/jrunner

Paul Trowbridge f084f8380a update readme for new deploy script and bump version to 1.0

Readme changes:
- Document that deployment directory must exist first
- Show mkdir -p commands before deploy
- Explain atomic deployment behavior (extracts to /tmp first)

Version bump to 1.0:
- Major refactoring: renamed app to jrunner
- Simplified deployment script
- Updated documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-01-06 22:37:05 -05:00

1.9 KiB

Raw Blame History

install java jdk.

find downloads page and get latest tarball. https://www.oracle.com/java/technologies/downloads/

wget https://download.oracle.com/java/19/latest/jdk-19_linux-x64_bin.tar.gz
tar -xvf downloaded_file

move the extracted folder to /opt put the extracted location in your path variable

export JAVA_HOME=/opt/jdk-19.0.1
export PATH=$PATH:$JAVA_HOME/bin

java --version to test

install gradle (optional)

Gradle wrapper (gradlew) is included in the repo, so manual Gradle installation is not required. If you prefer to install Gradle system-wide:

wget https://services.gradle.org/distributions/gradle-8.5-bin.zip
unzip -d /opt/gradle gradle-8.5-bin.zip
export PATH=$PATH:/opt/gradle/gradle-8.5/bin
gradle -v

clone this repo

git clone https://gitea.hptrow.me/pt/jrunner.git
cd jrunner

build

./gradlew build

deploy

using the deploy script (recommended)

First, create the deployment directory:

sudo mkdir -p /opt/jrunner

Then deploy:

# Deploy to /opt/jrunner (default, creates system-wide symlink)
./deploy.sh

# Deploy to custom location (for testing, no symlink)
sudo mkdir -p /opt/jrunner-test
./deploy.sh /opt/jrunner-test

The script builds, extracts to a temporary location, and only updates the target directory after the build succeeds. This ensures your existing deployment stays intact if the build fails. When deploying to /opt/jrunner, it creates a symlink at /usr/local/bin/jrunner.

manual deployment

./gradlew build
sudo unzip jrunner/build/distributions/jrunner.zip -d /opt/
sudo ln -sf /opt/jrunner/bin/jrunner /usr/local/bin/jrunner

usage

After deployment to default location:

jrunner -scu jdbc:postgresql://... -scn user -scp pass ...

After deployment to custom location:

/opt/jrunner-test/bin/jrunner -scu jdbc:postgresql://... -scn user -scp pass ...

1.9 KiB Raw Blame History