iochord/spring-runner

IOChord - Spring Runner## 镜像概述IOChord Spring Runner是一个用于运行基于Spring Framework的单jar应用的Docker镜像。它通过环境变量配置从指定仓库自动下载应用jar包，并完成应用的部署与启动，简化Spring应用的容器化部署流程。

核心功能和特性- 自动下载：根据配置的仓库地址和jar路径自动下载Spring应用jar包

• 灵活配置：支持通过环境变量自定义应用端口、存储路径、日志文件及启动参数
• 简化部署：无需手动处理jar包，直接通过环境变量配置即可完成应用部署
• 日志管理：默认将应用日志重定向到指定文件，便于日志收集和管理

使用场景和适用范围适用于需要快速部署和运行基于Spring Framework的单jar应用的场景，包括但不限于：

• 开发环境下的应用测试与调试
• 小型Spring Boot服务的容器化部署
• 需要动态切换不同版本Spring应用jar的场景

使用方法和配置说明### 环境变量配置以下环境变量用于配置镜像行为，所有变量均有默认值：

运行示例#### 直接运行```bash

docker run -p 30212:30212 docker.xuanyuan.run/iochord/spring-runner:0.0.1-SNAPSHOT

#### 后台运行（守护进程模式）```bash
docker run -d -p 30212:30212 docker.xuanyuan.run/iochord/spring-runner:0.0.1-SNAPSHOT

使用自定义应用jar```bash

docker run -p 30212:30212
-e RUNNER_REPOSITORY_JAR=ipr/ipr-lite-web/0.0.1-SNAPSHOT/ipr-lite-web-0.0.1-SNAPSHOT.jar
docker.xuanyuan.run/iochord/spring-runner:0.0.1-SNAPSHOT

## 工作原理### 前提条件应用jar包必须存在于`RUNNER_REPOSITORY_URI/RUNNER_REPOSITORY_JAR`指定的地址，且该地址可访问。

### 运行流程1. 创建应用存储路径：`mkdir -p $RUNNER_APP_PATH`
2. 下载应用jar包：从`$RUNNER_REPOSITORY_URI/$RUNNER_REPOSITORY_JAR`下载jar包至`$RUNNER_APP_PATH/$RUNNER_APP_JAR`
3. 启动应用：执行命令`java -jar $RUNNER_APP_PATH/$RUNNER_APP_JAR --logging.file=$RUNNER_APP_PATH/$RUNNER_APP_LOG --server.port=$RUNNER_APP_SERVER_PORT $RUNNER_APP_ARGUMENTS`

### 默认配置下的具体操作默认配置时，镜像将执行以下步骤：
1. 创建目录：`mkdir -p /var/iochord/app`
2. 下载jar包：`wget http://artifactory.tips.iochord.co.kr/artifactory/list/libs-snapshot-local/io/iochord/apps/ips/ips-simulator-web/0.0.1-SNAPSHOT/ips-simulator-web-0.0.1-SNAPSHOT.jar -O /var/iochord/app/app.jar`
3. 启动应用：`java -jar /var/iochord/app/app.jar --logging.file=/var/iochord/app/app.log --server.port=30212`