behance/docker-base

docker-base

![Build Status]([***]
https://hub.docker.com/r/behance/docker-base/tags/

镜像概述和主要用途

docker-base提供基础操作系统环境、安全补丁及工具集，旨在实现容器的快速启动与部署。该镜像集成进程管理、测试工具和便捷脚本，支持多种Linux发行版变体，适用于作为各类容器化应用的基础镜像。

核心功能和特性

支持的变体

• Ubuntu 18.04 LTS：标签格式为-VERSION#-ubuntu-18.04
• Ubuntu 20.04 LTS：标签格式为-VERSION#-ubuntu-20.04
• Alpine：标签格式为-alpine
• CentOS 7：标签格式为-centos-7
• CentOS 8：标签格式为-centos-8

集成工具

• S6：轻量级进程管理器，仅用于僵尸进程回收（作为PID 1）、启动协调及终止信号转换
• Goss：用于构建时测试的验证工具
• Dgoss：用于运行时测试的工具

使用场景和适用范围

适用于需要快速构建容器化应用的场景，尤其是需要进程管理、安全更新和跨架构支持的应用。可作为Web服务、后台任务、定时任务等各类应用的基础镜像。

使用方法和配置说明

服务监控配置

要添加被监控的服务，只需创建https://github.com/just-containers/s6-overlay#writing-a-service-script%E3%80%82
如需通过程序方式启用服务，可在/etc/services-available目录下创建服务，然后通过符号链接到/etc/services.d目录启用。

安全更新

提供安全补丁更新的便捷脚本：

• Ubuntu/CentOS变体：

  bash
  /bin/bash -e /security_updates.sh
  

  该脚本是/scripts目录下变体特定脚本的符号链接。

• Alpine变体：由于Alpine无法隔离安全更新，使用通用更新命令：

  bash
  apk update && apk upgrade
  

安装清理

所有变体均提供安装后的清理脚本：

bash
/bin/bash -e /clean.sh

该脚本同样是/scripts目录下变体特定脚本的符号链接。

环境变量

环境变量长度限制处理：
with-contenv工具无法读取超过4k字符的环境变量值。可使用/scripts/with-bigcontenv替代：

1. 从脚本shebang行移除with-contenv
2. 在shebang行后添加：source /scripts/with-bigcontenv

启动/运行时修改

如需在运行前注入配置，可在/etc/cont-init.d目录放置shell脚本。这些脚本将在S6进程管理初始化前执行。
详细说明：https://github.com/just-containers/s6-overlay#executing-initialization-andor-finalization-tasks

处理器架构支持

所有变体均支持x64和arm64架构，提供archstring脚本用于根据当前架构切换字符串：

bash
archstring --x64 intel --arm64 arm

在x64架构返回"intel"，在arm64架构返回"arm"，适用于需根据架构调整包名或下载路径的场景。

测试

• 构建时测试：容器通过https://github.com/aelsabbahy/goss%E5%9C%A8%E6%9E%84%E5%BB%BA%E8%BF%87%E7%A8%8B%E4%B8%AD%E8%87%AA%E6%B5%8B%E8%AF%95%E3%80%82%E5%A6%82%E9%9C%80%E6%B7%BB%E5%8A%A0%E6%B5%8B%E8%AF%95%EF%BC%8C%E5%8F%AF%E4%BF%AE%E6%94%B9%E6%88%96%E6%89%A9%E5%B1%95%60./container/root/goss.base.yaml%60%E6%96%87%E4%BB%B6%E3%80%82
• 运行时测试：执行test.sh脚本，使用https://github.com/aelsabbahy/goss/tree/master/extras/dgoss%E8%BF%9B%E8%A1%8C%E9%AA%8C%E8%AF%81%E3%80%82%E5%A6%82%E9%9C%80%E6%B7%BB%E5%8A%A0%E6%B5%8B%E8%AF%95%EF%BC%8C%E5%8F%AF%E6%89%A9%E5%B1%95%60./test.sh%60%E5%92%8C%60./goss.yaml%60%E6%96%87%E4%BB%B6%E3%80%82

高级修改

通过run.d系统实现高级配置：
/run.d目录下所有.sh结尾的shell脚本将在S6初始化前执行。

• 若脚本以非零退出码终止，容器将停止并返回该退出码，除非...
• 脚本以SIGNAL_BUILD_STOP（99）退出码终止，容器将干净停止（适用于多阶段构建）。

关闭行为

受监控服务崩溃时的事件序列

1. 执行S6 https://github.com/just-containers/s6-overlay#writing-an-optional-finish-script%EF%BC%8C%E6%9C%8D%E5%8A%A1%E8%BF%94%E5%9B%9E%E7%A0%81%E9%80%9A%E8%BF%87%60$%7B1%7D%60%E5%8F%98%E9%87%8F%E4%BC%A0%E9%80%92%E3%80%82
2. 若无finish脚本，服务将直接重启。
3. 若finish脚本指定终止容器，则执行管理员终止流程（见下文）。

管理员终止（docker stop）时的事件序列

1. 向所有受监控服务广播SIGTERM信号，S6_KILL_GRACETIME为等待服务响应的时间。超时未响应将发送SIGKILL。
2. 执行/etc/cont-finish.d目录下的脚本，每个脚本受S6_KILL_FINISH_MAXTIME限制。
3. 执行S6 https://github.com/just-containers/s6-overlay#writing-an-optional-finish-script%EF%BC%8C%E6%9C%8D%E5%8A%A1%E8%BF%94%E5%9B%9E%E7%A0%81%E9%80%9A%E8%BF%87%60$%7B1%7D%60%E5%8F%98%E9%87%8F%E4%BC%A0%E9%80%92%E3%80%82
4. 此后信号无法被捕获，所有服务应已停止，否则将执行：
   • 向所有服务广播SIGHUP
   • 向所有服务广播SIGTERM
   • 发送SIGKILL终止剩余进程

实现优雅关闭

1. 设置足够长的S6_KILL_FINISH_MAXTIME以确保服务正常关闭。
2. 在服务run脚本中捕获SIGTERM信号（暂不执行操作）。
3. 在/etc/cont-finish.d目录放置优雅关闭脚本，确保服务在S6_KILL_FINISH_MAXTIME内自行终止（如发送SIGWINCH或SIGQUIT信号）。

长时间运行的进程（工作进程+定时任务）

支持通过命令参数指定多个入口点，例如同时运行Web服务、定时任务和后台工作进程：

bash
docker run {image_id} /worker.sh 3 /bin/binary -parameters -that -binary -receives

上述命令将运行3个/bin/binary实例，参数为-parameters -that -binary -receives。

容器目录结构

容器构建时，./container/root目录会被覆盖到镜像中。以下为关键目录用途：