Docker 构建 nginxWebUI 容器实战

前言

nginxWebUI 项目并非本人所写，其国内国内项目地址： Gitee nginxWebUI ，官网：nginxWebUI.cn。

由于源项目并未提供 ARM 平台的适配，但是该项目提供了 Dockerfile 文件，我们可以根据 Dockerfile 的说明和项目的源码，进行 ARM 平台下的重编译和 Docker 容器构建。

非 ARM 平台的，也可以按照本文进行本平台的实战测试。

Java

对于源项目的源码来说，已经打包好了 x86_64 平台的 jar.tar.gz 包，该包内包含的 java 可执行程序是无法被用于 ARM 平台下运行。所以，虽然 arm64 系统的 Docker 可以下载源项目的镜像并保持容器的运行，但是实际上， ADD 到镜像内部的 jre 和 jar 包都是不能顺利执行的。

我们需要重新将 AArch64 的 jre 重新打包并用于容器构建。

下载

可以通过访问甲骨文（Oracle）的 jdk 下载官网，下载 AArch64 的 jdk 进行过滤打包： Oracle Java 8 。

实际上，Oracle 提供了 Java 8 和 Java 11 两个稳定版本的 AArch64 的 rpm 和 tar.gz （Compressed Archive）。但是为了使容器尽量的精简，这里使用 Java 8 来进行过滤打包。

简化过滤压缩

对下载得到的 jdk-8u291-linux-aarch64.tar.gz 进行解压。
```
tar -zxvf jdk-8u291-linux-aarch64.tar.gz
```
提取出要用的两部分，复制 ./jdk1.8.0_291/jre/ 文件夹到新建目录 ./jre1.8.0_291/ 下，并删除无用的、全是 .md 文件 legal 目录。
```
mkdir jre1.8.0_291
cp -r ./jdk1.8.0_291/jre/ ./jre1.8.0_291/
rm -r ./jre1.8.0_291/legal
```
重新压缩打包为 jre1.8.0_291.tar.gz 。
```
tar -zcvf jre1.8.0_291.tar.gz jre1.8.0_291
```
这时打包好的文件 40.13 MB ，解压后文件大小 106 MB 。注意这个数字，方便后面理解。

重新编译打包

由于源项目是基于 SpringBoot 的，对于 ARM 环境下的 jar 要重新进行编译。这是使用 Docker 搭建 ARM 下 Maven 环境来进行编译打包。

请参考： Docker 搭建 ARM 下 Maven 环境。

Dockerfile

原 Dockerfile 分析

FROM ubuntu:20.04
LABEL maintainer="cym1102@qq.com"
ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=Asia/Shanghai
RUN apt-get clean && apt-get update &&\
	apt-get install -y nginx &&\
	#apt-get install -y openjdk-11-jre &&\
	apt-get install -y net-tools &&\
	apt-get install -y curl &&\
	apt-get install -y wget &&\
	ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone &&\
	apt-get install tzdata
ENV LANG C.UTF-8
ADD jre.tar.gz /home/
RUN chmod 777 /home/jre/bin/java
ADD nginxWebUI.sh /home/
RUN chmod 777 /home/nginxWebUI.sh
COPY target/nginxWebUI-*.jar /home/nginxWebUI.jar
ENTRYPOINT ["sh","-c", "/home/nginxWebUI.sh ${BOOT_OPTIONS} && tail -f /dev/null"]

初始镜像为 ubuntu:20.04
维护者为 cym1102@qq.com
DEBIAN_FRONTEND ：环境变量，告知操作系统应该从哪儿获得用户输入。

设为 noninteractive 可以直接运行命令，而无需向用户请求输入（所有操作都是非交互式的）。这在运行apt-get命令的时候格外有用，因为它会不停的提示用户进行到了哪步并且需要不断确认。非交互模式会选择默认的选项并以最快的速度完成构建。

但是在源 Dockerfile 中，是使用 ENV 命令进行全局的设置，这会使该环境变量在整个容器运行过程中都会生效。本应确保只在 Dockerfile 中调用的 RUN 命令中设置该选项，以避免通过 /bin/bash 和容器进行交互时出问题。
```
# 示例
RUN DEBIAN_FRONTEND="noninteractive" apt-get -y install nginx
```

通过 RUN 安装环境。注意，源 Dockerfile 中将 openjdk-11-jre 的下载安装注释掉了，这里将安装情况展示出来就能明白了：

root@c26b3f28d05f:/# apt install openjdk-11-jre
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following additional packages will be installed:
  alsa-topology-conf ......
Suggested packages:
  default-dbus-session-bus ......
  fonts-wqy-microhei | fonts-wqy-zenhei fonts-indic mesa-utils
The following NEW packages will be installed:
  alsa-topology-conf ......
0 upgraded, 111 newly installed, 0 to remove and 11 not upgraded.
Need to get 80.8 MB of archives.
After this operation, 964 MB of additional disk space will be used.
Do you want to continue? [Y/n]

看到 964 MB 的时候，去和之前的解压后 106 MB 相比，就知道这是多么愚蠢的一件事了。

ADD 命令将源作者打包好的 jre.tar.gz 压缩包，添加到 /home 目录下解压，并对 /home/jre/bin/java 添加 777 权限。

ADD 命令将源作者的 nginxWebUI.sh 脚本，添加到 /home 目录下，并对其添加 777 权限。
COPY 将我们通过 Maven 容器编译好 jar 包复制到 /home/nginxWebUI.jar 。
ENTRYPOINT 作为默认入口命令，以 ["",......] 的形式由 exec 调用执行。

ls -c 让 bash 将一个字串作为完整的命令来执行，/home/nginxWebUI.sh ${BOOT_OPTIONS} 将参数传入脚本运行，利用 tail -f /dev/null 命令防止容器启动后退出（利用tail -f /dev/null命令防止container启动后退出）。

修改 Dockerfile

回顾下在本小节之前，本文中做了哪些工作：简化压缩了的 jre 包；重编译了 AArch64 的 jar 包。

接下来需要就修改了的文件对 Dockerfile 进行修改。

FROM ubuntu:20.04
LABEL author="cym1102@qq.com" date="2021-7-11" maintainer="xxxxxxxs@qq.com"
ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=Asia/Shanghai
RUN apt-get clean && apt-get update &&\
	apt-get install -y nginx &&\
	apt-get install -y net-tools &&\
	apt-get install -y curl &&\
	apt-get install -y wget &&\
	ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone &&\
	apt-get install tzdata
ENV LANG C.UTF-8
ADD jre1.8.0_291.tar.gz /home/
RUN chmod 777 /home/jre1.8.0_291/bin/java
ADD nginxWebUI.sh /home/
RUN chmod 777 /home/nginxWebUI.sh
COPY target/nginxWebUI-*.jar /home/nginxWebUI.jar
ENTRYPOINT ["sh","-c", "/home/nginxWebUI.sh ${BOOT_OPTIONS} && tail -f /dev/null"]

修改了 LABEL 的内容，由于要生成的新的镜像由本人构建，所以维护者（maintainer）是更改为本人邮箱，时间是 2021-7-11 ，作者保留为源项目作者 cym1102@qq.com 。
RUN 中删除了已注释的安装 openjdk-11-jre 的命令。
修改了导入 jre.tar.gz 的压缩包为 jre1.8.0_291.tar.gz ，并对对应的 java 可执行程序的路径进行修改。

脚本

若查看 nginxWebUI.sh 脚本的内容，会发现脚本中调用了导入的 java 可执行程序，所以也必须对脚本的内容进行修改。

源脚本内容：

#启动jar
nohup /home/jre/bin/java -jar -Xmx64m /home/nginxWebUI.jar $* > /dev/null &

修改 java 可执行程序对应路径即可：

#启动jar
nohup /home/jre1.8.0_291/bin/java -jar -Xmx64m /home/nginxWebUI.jar $* > /dev/null &

构建镜像

docker build -t [ACCOUNT]/nginxwebui:2.6.4 .

容器测试

启动容器

Docker 启动：

docker run -itd -v /home/nginxWebUI:/home/nginxWebUI -e BOOT_OPTIONS="--server.port=8080" --privileged=true --net=host --name nginxwebui-aarch64 yogile/nginxwebui-aarch64:latest /bin/bash

docker-compose 启动：

version: "3.2"
services:
  nginxWebUi-server:
    image: yogile/nginxwebui-aarch64:2.6.4
    volumes:
      - type: bind
        source: "/home/nginxWebUI"
        target: "/home/nginxWebUI"
    environment:
      BOOT_OPTIONS: "--server.port=8080"
    privileged: true
    network_mode: "host"

注意

由于目前市场上主流的大部分 ARM 平台处理器的性能并比不上 x86_64 的主流处理器性能，容器内 SpringBoot 项目的运行启动需要时间。

在本人的树莓派 4B 上初始化运行时，从创建容器到正式提供服务至少需要大约一分钟的时间，还请耐心等待。

posted @ 2021-07-12 16:54 Yogile 阅读(936) 评论(0) 编辑收藏举报

指间灵动，快码加编

刷新页面返回顶部

Yogile