• 周四. 12 月 12th, 2024

5G编程聚合网

5G时代下一个聚合的编程学习网

热门标签

Docker 构建 nginxWebUI 容器实战

admin

11 月 28, 2021

前言

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 来进行过滤打包。

简化过滤压缩

  1. 对下载得到的 jdk-8u291-linux-aarch64.tar.gz 进行解压。

    tar -zxvf jdk-8u291-linux-aarch64.tar.gz
    
  2. 提取出要用的两部分,复制 ./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
    
  3. 重新压缩打包为 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 环境 来进行编译打包。

Dockerfile

原 Dockerfile 分析

FROM ubuntu:20.04
LABEL maintainer="[email protected]"
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

  • 维护者为 [email protected]

  • 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 -cbash 将一个字串作为完整的命令来执行,/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="[email protected]" date="2021-7-11" maintainer="[email protected]"
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 ,作者保留为源项目作者 [email protected]
  • 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 上初始化运行时,从创建容器到正式提供服务至少需要大约一分钟的时间,还请耐心等待。

发表回复