前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Java程序制作Docker Image推荐方案

Java程序制作Docker Image推荐方案

作者头像
颇忒脱
发布2018-10-19 14:36:45
1.5K0
发布2018-10-19 14:36:45
举报
文章被收录于专栏:颇忒脱的技术博客

原文地址

本文的源代码在:https://github.com/chanjarste...

这里先给出一些Docker Image制作的要求,之后我们再看怎么做。

  1. 制作过程要融合在项目构建过程中
  2. 使用官方Image作为基础Image
  3. 设定正确的时区
  4. Container内的程序以非root用户启动
  5. 指定Web程序的接口
  6. 能够传递JVM参数、Java System Properties、程序自定义的参数

下面具体讲一下具体怎么做到以上几点:

制作过程要融合在项目构建过程中

这里推荐使用Spotify的dockerfile-maven-plugin,理由是这个plugin用起来最简单且容易掌握。

该plugin的本质上是你写一个Dockerfile(关于Dockerfile的具体写法请参照官方文档),这个plugin把一些参数传递进去来帮助你构建Docker Image。

因此只要你会写Dockerfile,就会使用这个plugin,它没有加入任何额外的概念。

使用官方Image作为基础Image

Java的基础镜像应该在openjdk repository里寻找,而不是在已经过时的java repository里找。

openjdk repository提供了各种各样的image tags看起来眼花缭乱,但是本质上来说就这么几个:

  • openjdk:<version>
  • openjdk:<version>-slim
  • openjdk:<version>-alpine

关于<version>一般来说指定大版本号就行了,比如你可以在Dockerfile这样写:

代码语言:javascript
复制
FROM openjdk:8-alpine

从尺寸上来讲,alpine最小、slim稍大、默认的最大。所以应该尽可能的使用alpine版本的,如果发现程序的运行环境缺少某些东西,那么尝试用slim版本或者默认版本。就目前的经验来讲:

  • 如果需要操作系统字体库,那么就得使用slim版本或者默认版本。需要操作系统字体库的程序例如:图片验证码、PDF导出。
  • 如果需要某些Linux标准的动态/静态连接库,那么在alpine版本不行的情况下,尝试slim版本或默认版本。因为alpine版本是一个及其精简的Linux,它删除了很多东西。

设定正确的时区

几乎所有的Docker Image的时区都是UTC,我们需要给我们自己制作的Docker Image设定时区(参考的是SO的这个回答):

代码语言:javascript
复制
ENV TZ=Asia/Shanghai
RUN set -eux; \
    ln -snf /usr/share/zoneinfo/$TZ /etc/localtime; \
    echo $TZ > /etc/timezone

关于数据库时区的相关内容可以见:

Container内的程序以非root用户启动

在Docker Image内部,我们应该使用非root用户启动程序,这需要使用到gosu

gosu的Dockerfile指南在这里

记得要根据不同的基础Image选择适合的安装方式。

如果你用的是openjdk:<version>-alpine,那么直接用本项目提供的Dockerfile就行了。

如果你用的是openjdk:<version>-slim或者openjdk:<version>,那么在Image里安装gosu的方式是这样:

代码语言:javascript
复制
RUN set -ex; \
    apt update; \
    apt install -y gosu; \
    rm -rf /var/lib/apt/lists/*; \
# verify that the binary works
    gosu nobody true;

指定Web程序的接口

对于联网应用而言,必须在Dockerfile中指定暴露的端口,否则该端口无法映射。

代码语言:javascript
复制
EXPOSE 8080

能够传递JVM参数、Java System Properties、程序自定义的参数

我们需要能够在启动Docker Image的时候将一些参数传递进去:

  • JVM参数
  • Java System Properties
  • 程序启动参数

这里就需要参考Dockerfile best practiceDocker ENTRYPOINT了。

样例项目

样例项目源代码在这里:https://github.com/chanjarster/dockerfile-examples/

目录结构

所有与程序相关的东西都存放在/home/java-app/下:

代码语言:javascript
复制
/home/java-app
   ├── docker-entrypoint.sh
   ├── lib
   │   └── java-app.jar
   ├── etc
   ├── logs
   └── tmp
  • docker-entrypoint.sh,启动脚本
  • lib,存放JAR包
  • lib/java-app.jar,程序JAR包
  • etc,存放配置文件
  • logs,存放日志文件
  • tmp,存放临时文件

构建Image的方法

代码语言:javascript
复制
mvn clean package dockerfile:build

运行

普通启动,然后访问http://localhost:8080

代码语言:javascript
复制
docker run -p 8080:8080 chanjarster/dockerfile-java-examples-1:1.0-SNAPSHOT

设定JVM参数,使用JVM_OPTS环境变量:

代码语言:javascript
复制
docker run -p 8080:8080 -e JVM_OPTS='-Xmx128M -Xms128M' chanjarster/dockerfile-java-examples-1:1.0-SNAPSHOT

设定System Properties,使用JAVA_ARGS环境变量:

代码语言:javascript
复制
docker run -p 8080:8080 -e JAVA_ARGS='-Dabc=xyz -Ddef=uvw' chanjarster/dockerfile-java-examples-1:1.0-SNAPSHOT

提供程序运行参数,在后面直接添加即可:

代码语言:javascript
复制
docker run -p 8080:8080 chanjarster/dockerfile-java-examples-1:1.0-SNAPSHOT --debug

参考文档

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 制作过程要融合在项目构建过程中
  • 使用官方Image作为基础Image
  • 设定正确的时区
  • Container内的程序以非root用户启动
  • 指定Web程序的接口
  • 能够传递JVM参数、Java System Properties、程序自定义的参数
  • 样例项目
    • 目录结构
      • 构建Image的方法
        • 运行
        • 参考文档
        相关产品与服务
        容器镜像服务
        容器镜像服务(Tencent Container Registry,TCR)为您提供安全独享、高性能的容器镜像托管分发服务。您可同时在全球多个地域创建独享实例,以实现容器镜像的就近拉取,降低拉取时间,节约带宽成本。TCR 提供细颗粒度的权限管理及访问控制,保障您的数据安全。
        领券
        问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档