在前文中,我们详尽阐述了QQ机器人的搭建过程及其最终实现的各项功能展示。接下来,我们将转向探讨该项目基于Docker构建服务的具体实践。本篇将以QQ机器人签名服务——qsign为起点,逐步展开论述。
1 获取和运行 xzhouqd/qsign:8.9.63 镜像
1.1 获取镜像
获取镜像有两种方式
1.1.1 从 Docker Hub 拉取镜像
docker pull xzhouqd/qsign:8.9.63
1.1.2 从本地存储文件加载镜像
docker load -i xzhouqd_qsign_8.9.63.tar
上面提及的示例文件 “xzhouqd_qsign_8.9.63.tar” ,实际上是由 Docker 镜像导出并存储到本地的压缩文件。那么,这样的文件是如何生成的呢?接下来,我们将逐步揭示这一过程。
首先,我们需要使用 Docker 的镜像列举命令来确认目标镜像是否已经存在于本地的 Docker 环境中:
docker images
执行的结果如下图:
通过执行上述命令,您将看到一个列表,其中包含了本地已有的所有镜像或指定镜像的信息。如果目标镜像确实存在,它将在列表中显示;否则,需要从远程仓库(如Docker Hub)拉取或通过其他方式获取(如:1.1.1所述 )。
假设“xzhouqd/qsign:8.9.63”镜像已存在于本地Docker环境中,接下来我们将演示如何将其导出为.tar文件:
docker save -o xzhouqd_qsign_8.9.63.tar xzhouqd/qsign:8.9.63
这条命令中:
- docker save 是用于导出镜像的Docker命令。
- -o xzhouqd_qsign_8.9.63.tar 指定了导出后压缩文件的名称和路径。
- xzhouqd/qsign:8.9.63 是要导出的镜像的完整名称(包括仓库名、镜像名和标签)。
执行此命令后,Docker将把指定镜像及其依赖的所有层打包成一个名为“xzhouqd_qsign_8.9.63.tar”的.tar文件,并将其保存到当前工作目录下。至此,我们就成功创建了由Docker镜像生成的本地压缩文件。
1.2 由镜像运行生成容器
docker run -d `# -d 表示保持后台运行` \--restart=always `# 表示开机即自动运行` \--name bs-qsign `容器名称` \-p 18080:8080 `# 端口映射,将容器的 8080 端口映射到宿主机的 18080 端口` \-e ANDROID_ID=xxxxxxx `# 此值可以随便设置,但需要和 cqhttp 里的设置一致` \xzhouqd/qsign:8.9.63 # 镜像文件
小贴士:
在多行Shell命令文件中,欲在行尾使用反斜杠 \ 进行续行的同时添加注释,可于 \ 之前插入一对反引号 ` 包裹的 # 字符来实现,以此实现续行与注释的结合。
至此,bs-qsign 签名服务器已顺利完成搭建。为便于后续进行参数的动态调整、实现与其他容器间配置的统一管理,以及一键启动具有复杂功能的扩展服务,建议将相关参数迁移至配置文件进行妥善存储。
2 创建配置文件:config.sh
此配置文件,由以下几个部分构成
2.1 基本参数
appName="bs-qsign" # 应用名称
appVersion="0.0.1" # 应用版本号
imageName="xzhouqd/qsign:8.9.63" # 镜像名称
containerName="$appName" # 容器名称
2.2 docker run 相关配置
通常情况下,我们在配置Docker容器时会涉及以下三个核心要素:
-
Volumes —— 用于宿主机与容器之间实现文件或目录的双向同步映射,确保数据持久化及共享。在配置文件里以变量
volumes
表示。 -
Ports —— 通过端口映射,使得外部能够访问到容器内部运行的服务,实现网络通信。在配置文件里以变量
ports
表示。 -
Environments —— 设置环境变量,为容器内应用程序提供必要的运行时配置信息。在配置文件里以变量
envs
表示。
对于上述各项配置,可根据实际应用场景自由选择适用的项目。对于暂时无需使用的配置项,可以选择对其进行注释以备后续参考,或者直接删除以保持配置文件简洁。
# docker run 相关配置(可选项,如为空,可不填)volumes=(/path_in_host:/path_in_container)
# /path_in_host - 宿主机目录
# /path_in_container - 容器目录ports=("18080:8080") # 宿主机端口:容器端口envs=("ANDROID_ID=tanbushi01") # 变量名=变量值
上述以圆括号 () 包围的数据结构在Shell脚本中定义了一个数组。其中,用单引号或双引号包裹的文本构成数组的各个元素,多个元素之间以空格分隔。以包含多个端口映射的数组为例:
ports=("18080:8080" "15703:5703")
这里,数组 ports 包含两个元素:“18080:8080” 和 “15703:5703”,分别代表将宿主机的18080端口映射到容器的8080端口,以及将宿主机的15703端口映射到容器的5703端口。
类似地,对于 volumes(卷映射)和 envs(环境变量)数组的定义,只需按照相同的方式指定各自的映射关系或环境变量键值对即可:
volumes=("host_path1:container_path1" "host_path2:container_path2")
envs=("VAR1=value1" "VAR2=value2")
以上述方式声明的 volumes 数组表示将宿主机的 host_path1 目录映射到容器的 container_path1,host_path2 目录映射到 container_path2。而 envs 数组则设置了两个环境变量:VAR1 的值为 value1,VAR2 的值为 value2。
2.3 标记 config.sh 脚本执行状态
通过设置变量 configured 来标记 config.sh 脚本是否已执行过:
configured=true
当该变量值为 true 时,表明 config.sh 脚本已成功执行过一次,旨在防止后续重复加载或执行配置,确保系统的稳定性和一致性。
最终的config.sh内容如下:
#!/bin/bash# 基本参数
appName="bs-qsign" # 应用名称
appVersion="0.0.1" # 应用版本号
imageName="xzhouqd/qsign:8.9.63" # 镜像名称
containerName="$appName" # 容器名称# docker run 相关配置(可选项,如为空,可不填)
ports=("18080:8080")
envs=("ANDROID_ID=tanbushi01")# 标记是否已经配置过
configured=true # 标记变量——此脚本已经被执行过
3 运行容器的脚本:run.sh
#!/bin/bash# 运行初始化脚本
. ../../shell-scripts/run_init.sh# 创建并执行临时文件——实现 docker run 命令(临时文件不是在容器里哦!)
. ../../shell-scripts/run_in_tmp.shecho ""
echo "*********************************************************"
echo "成功创建容器:【 $containerName 】!"
echo "*********************************************************"
echo ""
3.1 初始化脚本:run_init.sh
#!/bin/bashset -e # 遇到错误时退出脚本# 判断是否运行过配置文件 config.sh,如果未运行过,则运行配置文件
if [ -z "$configured" ]; then. ./config.sh
fi# 检查 Docker 是否在运行
if ! docker info > /dev/null 2>&1; thenecho "Docker 没有运行。请启动 Docker 再试!"exit 1
fi# 查看指定名称和TAG的镜像是否存在
str=$imageName
IFS=":"
read -ra parts <<< "$str"
_img_name=${parts[0]}
_img_tag=${parts[1]}
set +e
rslt=`docker images | grep -E "^$_img_name\s+$_img_tag\s+"`
set -e
# 判断字符串是否为空
if [ -z "$rslt" ]; thenecho "镜像不存在,请先构建镜像!"exit 2
fi# 检查容器是否存在
if docker ps -a --filter "name=$containerName" | grep -q "$containerName"; thenecho ""echo "容器【 $containerName 】存在,先停止,再删除..."# 容器存在,先停止,再删除echo ""echo "停止容器【 $containerName 】..."docker stop $containerName > /dev/null 2>&1echo ""echo "删除容器【 $containerName 】..."echo ""docker rm $containerName > /dev/null 2>&1
fi
3.2 临时生成的运行 docker run 的脚本:run_in_tmp.sh
#!/bin/bashOS=$(uname)is_windows=falsecase "$OS" inLinux) # 在 Linux 系统上运行 ;;Darwin) # 在 macOS 系统上运行;;CYGWIN*|MINGW32*|MSYS*|MINGW*) # 在 Windows 系统上运行is_windows=true;;*)echo "Unknown OS: $OS" # 在其他系统上运行;;
esac# 执行 docker run 命令的临时脚本文件名
shell_script="/tmp/${containerName}_run.sh"# 输出数组元素生成映射 volume、port、env
function exportMapItems() {local script_name=$1 # 脚本文件名shiftlocal type_prefix=$1 # 类型前缀shift # 如果是windows,同时$type_prefix是-v 则自动添加斜杠if [ "$is_windows" = true ] && [ "$type_prefix" = "-v" ]; thenauto_slash=/elseauto_slash=""fi# echo "auto_slash=$auto_slash"local -a items=("$@")for map_item in "${items[@]}"; do# 输出数组元素echo " ${type_prefix} ${auto_slash}${map_item} \\" >> $script_name# echo " ${type_prefix} ${auto_slash}${map_item} \\"done
}# 创建临时文件:/tmp/_run.sh(不是在容器里哦!)
echo "#!/bin/bash" > $shell_script
echo "" >> $shell_script
echo "docker run -itd \\" >> $shell_script
echo " --restart always \\" >> $shell_script# 写入 volumes,注意,此处只能是-v,不是-V
exportMapItems $shell_script "-v" "${volumes[@]}"# 写入 ports,注意,此处只能是-p,不是-P
exportMapItems $shell_script "-p" "${ports[@]}"# 写入 envs,注意,此处只能是-e,不是-E
exportMapItems $shell_script "-e" "${envs[@]}"# 写入 name
echo " --name $containerName \\" >> $shell_script# 写入 imageName
echo " $imageName" >> $shell_scriptchmod 755 $shell_script
. $shell_script
rm -f $shell_script
4 总结
本篇首先讲述了Docker 镜像拉取、保持到本地、从本地加载等操作流程;其次通过两个文件构建了一种可配置的机制,使得基于指定镜像创建并运行容器的过程更具通用性和灵活性。不仅适用于当前的 bs-qsign 服务部署场景,还能无缝应用于后续提及的其他服务搭建,从而增强了部署流程的标准化程度、适应性和代码复用性。
上一篇:docker安装并跑通跑通QQ机器人实践(1)-前言及展示
下一篇:敬请期待…