SQLynx(原SQL Studio)镜像制作更新
嘿嘿嘿!??
编辑于 2024年06月25日 17:05
收录于文集
共2篇

前因

之前写过一篇 SQLynx(原 SQL Studio)的容器制造和使用的文档,文档链接 SQL Studio 容器制作与部署​ ,里面的 dockerfile 在编写时有很多问题,使用 CentOS 作为基础镜像,镜像占用空间较大,因为官方也停止了支持,所以决定重新编写一份 dockerfile ,使用 alpine 作为基础镜像。

制作镜像

新版 dockerfile 如下

2.0.0 至 2.1.1 版本使用如下 dockerfile

(看通用版本吧,这个也能用,通用版本实用于2.0.0的所有版本)

代码块
YAML
自动换行
复制代码
FROM alpine:3.18.3

ARG SQLYNX_VERSION=2.0.0

WORKDIR /apps

RUN set -x \
    && apk update -v \
    && apk add --no-cache bash \
    && apk add --no-cache openjdk8-jre openjdk8-jre-lib \
    && apk add --no-cache wget curl iputils unzip zip \
    && apk cache clean \
    && rm -rf /var/cache/apk/*

RUN set -x \
    && wget http://maicong-software-1302946156.cos.ap-beijing.myqcloud.com/software/sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && unzip sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && rm -rf sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip

RUN echo -e '#!/bin/bash\n/apps/sqlynx/maicong-sqlynx.sh start && tail -f sqlynx/log/maicong-sqlynx-console.log' > 1 > /apps/sqlynx/start.sh \
    && chmod a+x /apps/sqlynx/start.sh

EXPOSE 18888

CMD ["/bin/bash", "/apps/sqlynx/start.sh"]
复制成功

文件注释如下

代码块
YAML
自动换行
复制代码
# 声明基础镜像为 alpine:3.18.3
FROM alpine:3.18.3

# 使用 ARG 定义变量,该变量用于传递 sqlynx 的版本号
ARG SQLYNX_VERSION=2.0.0

# 声明 容器工作目录
WORKDIR /apps

# 安装 JDK 的运行环境
RUN set -x \
    && apk update -v \
    && apk add --no-cache bash \
    && apk add --no-cache openjdk8-jre openjdk8-jre-lib \
    && apk add --no-cache wget curl iputils unzip zip \
    && apk cache clean \
    && rm -rf /var/cache/apk/*

# 使用 ARG 传递的版本信息 下载 解压对应版本的 sqlynx_linux_no_jdk 的包
RUN set -x \
    && wget http://maicong-software-1302946156.cos.ap-beijing.myqcloud.com/software/sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && unzip sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && rm -rf sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip

# 生成启动脚本,官方并没有启动脚本里提供后台启动的方式,故采用曲线救国的方式在前台查看日志来保证容器的存活
# 关于后台启动的方式,我考虑过修改官方的启动脚本添加后台启动但是转念想了下,没有必要,如果这样做了每次都要修改官方脚本就很浪费时间,在构建时也不能保证 dockerfile 在 2.0.X 的通用性,还有个原因我懒。
# 我也和 官方 反馈过,在启动脚本里加后台启动的内容了
RUN echo -e '#!/bin/bash\n/apps/sqlynx/maicong-sqlynx.sh start && tail -f sqlynx/log/maicong-sqlynx-console.log' > 1 > /apps/sqlynx/start.sh \
    && chmod a+x /apps/sqlynx/start.sh

# 声明 容器端口
EXPOSE 18888

# 声明 启动参数
CMD ["/bin/bash", "/apps/sqlynx/start.sh"]
复制成功

2.1.2版本后使用如下 dockerfile 

(看通用版本吧,这个也能用,通用版本实用于2.0.0的所有版本)

麦聪软件修改了打包后文件的文件名规则,新增加了软链的过程

代码块
YAML
自动换行
复制代码
FROM alpine:3.18.3

ARG SQLYNX_VERSION=2.0.0

WORKDIR /apps

RUN set -x \
    && apk update -v \
    && apk add --no-cache bash \
    && apk add --no-cache openjdk8-jre openjdk8-jre-lib \
    && apk add --no-cache wget curl iputils unzip zip \
    && apk cache clean \
    && rm -rf /var/cache/apk/*

RUN set -x \
    && wget http://maicong-software-1302946156.cos.ap-beijing.myqcloud.com/software/sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && unzip sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && ln -s sqlynx_linux_${SQLYNX_VERSION} sqlynx \
    && rm -rf sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip

RUN echo -e '#!/bin/bash\n/apps/sqlynx/maicong-sqlynx.sh start && tail -f sqlynx/log/maicong-sqlynx-console.log' > 1 > /apps/sqlynx/start.sh \
    && chmod a+x /apps/sqlynx/start.sh

EXPOSE 18888

CMD ["/bin/bash", "/apps/sqlynx/start.sh"]
~
复制成功

文件注释参考前文

只增加了如下部分

代码块
Shell
自动换行
复制代码
&& ln -s sqlynx_linux_${SQLYNX_VERSION} sqlynx \
# 将解压后带有版本信息的文件软链接为sqlynx,为后面的传入脚本服务
复制成功

可能是通用的dockerfile版本

不幸的是麦聪官方​又一次修改了压缩包的一级目录的目录名,但幸运的是我想到了办法,用 awk 提取压缩包的一级目录,然后通过前面软链的方法解决,只要麦聪不大改目录结构问题就不大。

代码块
YAML
自动换行
复制代码
FROM alpine:3.18.3

ARG SQLYNX_VERSION=2.0.0

WORKDIR /apps

RUN set -eux && sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories

RUN set -x \
    && apk update -v \
    && apk add --no-cache bash \
    && apk add --no-cache openjdk8-jre openjdk8-jre-lib \
    && apk add --no-cache wget curl iputils unzip zip \
    && apk cache clean \
    && rm -rf /var/cache/apk/*

RUN set -x \
    && wget http://maicong-software-1302946156.cos.ap-beijing.myqcloud.com/software/sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && unzip sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
#    && ln -s `unzip -l sqlynx_linux_no_jdk_2.2.0.zip | awk '{print $4}' | awk -F '/' '{print $1}' | grep -v '^$' | tail -1` sqlynx \
    && ln -s `unzip -l sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip | awk 'NR==4 {split($4, arr, "/"); print arr[1]; exit}'` sqlynx \
    && rm -rf sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip

RUN echo -e '#!/bin/bash\n/apps/sqlynx/maicong-sqlynx.sh start && tail -f sqlynx/log/maicong-sqlynx-console.log' > 1 > /apps/sqlynx/start.sh \
    && chmod a+x /apps/sqlynx/start.sh

EXPOSE 18888

CMD ["/bin/bash", "/apps/sqlynx/start.sh"]
复制成功

文件注释参考前文

变更了如下部分

代码块
YAML
自动换行
复制代码
ln -s `unzip -l sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip | awk '{print $4}' | awk -F '/' '{print $1}' | grep -v '^$' | tail -1` sqlynx 
# 笨办法 awk 先取第4列,然后 awk 取“/”分割的第一列,继续 grep 取非空行,最后 tail 取最后一行

ln -s `unzip -l sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip | awk 'NR==4 {split($4, arr, "/"); print arr[1]; exit}'` sqlynx 
# 巧办法 NR==4 表示只处理第四行,split($4, arr, "/") 将第四列 $4 使用斜杠 (/) 分割成数组 arr,print arr[1] 打印数组 arr 的第一个元素。exit 关键字用于退出 awk 处理,确保只打印第一个匹配的结果。
复制成功

2024.06.25 可能是最终优化版本

本次针对 dockerfile 进行了优化,升级了基础镜像的 alpine 的版本为 3.20.1 ,优化了启动脚本,彻底解决在前台启动时无法通过 ctrl+c 等终止信号关闭容器的问题。

新版 dockerfile 文件如下

代码块
YAML
自动换行
复制代码
# 使用 Alpine Linux 3.20.1 作为基础镜像
FROM alpine:3.20.1

# 设置 SQLynx 的版本号,默认为 2.0.0
ARG SQLYNX_VERSION=2.0.0

# 设置工作目录为 /apps
WORKDIR /apps

# 替换默认的 Alpine 镜像源为中国科技大学的镜像源
RUN set -eux && sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories

# 更新并安装必要的软件包,包括 bash、OpenJDK 8 JRE、wget、curl 等
RUN set -x \
    && apk update -v \
    && apk add --no-cache bash openjdk8-jre openjdk8-jre-lib wget curl iputils unzip zip \
    && apk cache clean \
    && rm -rf /var/cache/apk/*

# 下载并解压 SQLynx 应用程序,并创建符号链接
RUN set -x \
    && wget http://maicong-software-1302946156.cos.ap-beijing.myqcloud.com/software/sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && unzip sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip \
    && ln -s `unzip -l sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip | awk 'NR==4 {split($4, arr, "/"); print arr[1]; exit}'` sqlynx \
    && rm -rf sqlynx_linux_no_jdk_${SQLYNX_VERSION}.zip

# 创建启动脚本 start.sh,包含启动 SQLynx、处理信号和输出日志
RUN echo -e '#!/bin/bash\n bash /apps/sqlynx/maicong-sqlynx.sh start \n trap "echo Stopping SQLynx...;bash /apps/sqlynx/maicong-sqlynx.sh stop; exit 0" SIGINT SIGTERM \n tail -f /apps/sqlynx/log/maicong-sqlynx-console.log & \n wait $!' > /apps/sqlynx/start.sh && chmod a+x /apps/sqlynx/start.sh

# 暴露端口 18888
EXPOSE 18888

# 定义容器启动时运行的命令
CMD ["/bin/bash", "/apps/sqlynx/start.sh"]
复制成功

前台启动时无法通过 ctrl+c 等终止信号关闭容器解决方法

dockerfile

代码块
YAML
自动换行
复制代码
RUN echo -e '#!/bin/bash\n bash /apps/sqlynx/maicong-sqlynx.sh start \n trap "echo Stopping SQLynx...;bash /apps/sqlynx/maicong-sqlynx.sh stop; exit 0" SIGINT SIGTERM \n tail -f /apps/sqlynx/log/maicong-sqlynx-console.log & \n wait $!' > /apps/sqlynx/start.sh && chmod a+x /apps/sqlynx/start.sh
复制成功

转换为 shell 脚本

代码块
Shell
自动换行
复制代码
#!/bin/bash

# Start the SQLynx application in the background
bash /apps/sqlynx/maicong-sqlynx.sh start

# Trap signals to properly shut down the application and exit
trap "echo Stopping SQLynx...;bash /apps/sqlynx/maicong-sqlynx.sh stop; exit 0" SIGINT SIGTERM

# Tail the log file to keep the container running
tail -f /apps/sqlynx/log/maicong-sqlynx-console.log &
wait $!
复制成功

分步解释

代码块
Shell
自动换行
复制代码
#!/bin/bash
# 指定使用 Bash 解释器来执行脚本。

bash /apps/sqlynx/maicong-sqlynx.sh start
# 执行 SQLynx 的启动脚本 maicong-sqlynx.sh,启动 SQLynx 应用程序。

trap "echo Stopping SQLynx...;bash /apps/sqlynx/maicong-sqlynx.sh stop; exit 0" SIGINT SIGTERM
# 设置了一个信号处理器 (trap),当接收到 SIGINT (Ctrl+C) 或 SIGTERM 信号时,执行指定的命令来优雅地停止 SQLynx。

tail -f /apps/sqlynx/log/maicong-sqlynx-console.log &
# 启动一个后台任务,实时监视 SQLynx 的日志文件 maicong-sqlynx-console.log。

wait $!
# 等待后台任务的结束。这里 $! 是前一个后台任务的进程 ID。
复制成功

构建镜像

使用如下构建命令配合 dockerfile ,只需要在构建时传入版本号,即可实现指定版本的构建,不需要每次手动下载安装包再 COPY 或 ADD 传入容器了。

传统构建命令如下

代码块
Shell
自动换行
复制代码
docker build -f dockerfile  --build-arg  SQLYNX_VERSION=2.0.2  --tag sqlynx:2.0.2 .
复制成功

注:

代码块
Shell
自动换行
复制代码
--build-arg  SQLYNX_VERSION=版本号(官网上面的版本号是啥就填啥) --tag 指定镜像标签,建议使用 sqlynx:版本号 
复制成功

buildx 构建命令如下

代码块
Shell
自动换行
复制代码
docker buildx build --build-arg SQLYNX_VERSION=2.1.2 --tag sqlynx:2.1.2 --platform=linux/amd64  . --load
复制成功

注:

代码块
Shell
自动换行
复制代码
--build-arg  SQLYNX_VERSION=版本号(官网上面的版本号是啥就填啥)
--tag 指定镜像标签,建议使用 sqlynx:版本号 
复制成功

本人会在官方更行后的第一时间(看我多会发现麦聪他们偷偷发版了)制作镜像并发布到如下镜像仓库

代码块
Shell
自动换行
复制代码
registry.cn-hangzhou.aliyuncs.com/sql_studio/sqlynx:同步版本号
复制成功

如需了解 SQL Studio 更多详细操作,请移步如下地址

麦聪软件官网

http://www.maicongs.com/#/home/web

麦聪软件的个人空间-麦聪软件个人主页-哔哩哔哩视频​