sudobmitch/base

Docker Base镜像（sudobmitch/base）

镜像概述

该镜像由Brandon Mitchell维护，提供一系列实用工具和脚本，旨在简化Docker容器的初始化、权限管理、卷缓存及健康检查等流程，适用于扩展Debian、Alpine等基础镜像。

核心功能

• entrypoint脚本管理：支持执行/etc/entrypoint.d下的.env文件（环境变量）和.sh脚本（按顺序执行）。
• 实用工具集：包含wait-for-it.sh（等待服务启动）、fix-perms（卷权限匹配）、gosu（切换非root用户）、save-volume/load-volume（卷缓存）、stop-on-trigger（条件停止容器）等。
• Secrets处理：将环境变量中的{DOCKER_SECRET:xyz}替换为/run/secrets/xyz的内容。
• 健康检查支持：通过/etc/healthcheck.d下的脚本实现健康检查逻辑。
• 平台增强：Debian镜像含apt-install（非交互安装），Alpine镜像含apk-install（无缓存安装）及shadow包（用户管理）。

使用场景

• 简化容器初始化流程，自动执行预启动脚本。
• 管理非root用户权限，解决卷挂载权限问题。
• 缓存卷数据，初始化主机卷或tmpfs卷内容。
• 实现证书更新等条件触发的容器重启。
• 集成自定义证书 authorities（CA）。

配置说明

环境变量

• ORIG_ENTRYPOINT：非空时作为命令前缀执行。
• USE_INIT：非空时用tini处理僵尸进程。
• RUN_AS：非空时用gosu切换到指定用户运行命令。

entrypoint.d使用

1. 将.env文件（环境变量）或.sh脚本（可执行）放入/etc/entrypoint.d。
2. 文件按名称顺序执行。

卷缓存操作

1. Dockerfile中用RUN save-volume /path/to/dir缓存目录。
2. 启动时调用load-volume /path/to/dir或通过entrypointd.sh自动加载。
   • 选项：-d（删除卷文件，依赖rsync）；-u（强制更新卷）。

stop-on-trigger使用

• 后台运行：stop-on-trigger -m /etc/certs/host.pem &（文件修改时停止容器）。
• 需设置USE_INIT=1启用tini处理信号。

证书配置

• 将CA证书（.pem/.crt）放入/etc/certs.d。
• 需安装ca-certificates包，且容器以root启动。

部署示例

扩展scratch镜像

dockerfile
FROM your_base_image
COPY --from=sudobmitch/base:scratch / /
# 扩展Alpine需安装shadow包
RUN apk add --no-cache shadow

entrypoint脚本示例

sh
#!/bin/sh
# 监控证书变化
stop-on-trigger -m /etc/certs/host.pem &
# 执行原命令
exec "$@"