Sign inSign up

minstonehub/spring-runner

By minstonehub

Updated over 2 years ago

Image
0

1.2K

minstonehub/spring-runner repository overview

Spring Runner

概述

  本镜像主要用于运行基于 Spring Boot 的可执行程序。

使用说明

声明子镜像
# 继承 Spring Runner
FROM minstonehub/spring-runner:8

# 将可执行程序复制到工作目录,并重命名为 application.jar
COPY application-1.0.0.RELEASE.jar application.jar

# 声明暴露端口
EXPOSE 8080
编译子镜像
$ docker build -t application:latest .
运行子镜像
$ docker run -p 8080:8080 application:latest

配置镜像

修改时区

  本镜像默认时区为 Asia/Shanghai,如果开发者需要修改时区,可以通过添加环境变量修改,如下:

$ docker run -p 8080:8080 -e TZ=Europe/London application:latest
修改可执行文件名称

  本镜像默认可执行文件的名称是 application.jar,因此开发者在使用本镜像时,应参考使用说明里的 Dockerfile,将复制进来的可执行文件名修改为 application.jar。如果需要修改默认的可执行文件名称,可以添加一个 RUNNER_EXECUTABLE 环境变量,声明新的可执行文件名称,如下:

FROM minstonehub/spring-runner:8

# 修改可执行文件名称
ENV RUNNER_EXECUTABLE=spring-application.war

# 将可执行程序复制进来,并重命名为指定的可执行文件名称
COPY application-1.0.0.RELEASE.war spring-application.war

EXPOSE 8080
JVM 调优

  本镜像默认为 JVM 设置 -Xms256m -Xmx256m 调优参数。如果子镜像需要定制调优参数,可以通过以下方法:

  • 修改镜像默认调优参数
FROM minstonehub/spring-runner:8
COPY application-1.0.0.RELEASE.jar application.jar
EXPOSE 8080

# 修改启动时的 JVM 调优参数
CMD ["-Xms512m", "-Xmx512m", "-XX:+UseG1GC"]
  • 在运行时添加调优参数

  你也可以在启动 Docker 镜像时添加调优参数,如下:

$ docker run -p 8080:8080 application:latest -Xms512m -Xmx512m -XX:+UseG1GC

镜像逻辑

编译逻辑
  • 添加容器启动辅助工具 entrypoint.shgosu
  • 创建 runner 用户和 runner 用户组
  • 创建工作目录 /workspace
    • 创建配置目录:/workspace/config
    • 创建日志目录:/workspace/logs
    • 创建数据目录:/workspace/data
  • 执行启动脚本 entrypoint.sh
运行逻辑
  • 如果设置了 TZ 环境变量,则变更镜像的时区信息
  • /workspace 及子目录授权给 runner 用户,保证可执行文件可以正常通用 runner 用户运行
  • 生成 Java 运行参数、Spring 运行参数
  • runner 用户运行可执行文件。

Tag summary

Content type

Image

Digest

sha256:1337dda9f

Size

240.2 MB

Last updated

over 2 years ago

docker pull minstonehub/spring-runner:17-jdk-ubuntu