p3terx/s6-alpine

Alpine Linux with S6 Overlay 镜像文档

镜像概述

本镜像基于轻量级的Alpine Linux发行版，并集成了S6 Overlay进程管理工具，旨在为容器化应用提供一个精简、高效且具备可靠进程管理能力的基础环境。Alpine Linux的轻量级特性确保镜像体积小巧，而S6 Overlay则提供了容器内多进程管理、服务监督及优雅启停等核心功能。

核心功能与特性

基础环境特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 安全性：Alpine Linux默认采用最小化安装，减少潜在安全风险
• 兼容性：兼容大多数基于Alpine的应用生态

S6 Overlay特性

• 进程管理：支持容器内多进程管理，解决传统容器单进程限制
• 服务监督：提供进程监控与自动重启能力，确保服务可用性
• 生命周期管理：支持优雅启动、停止及信号处理，符合容器最佳实践
• 配置灵活：通过简单的目录结构即可定义服务启动顺序和依赖关系

使用场景

• 构建需要运行多个进程的容器化应用（如Web服务+数据库、应用服务器+日志收集器等）
• 需要可靠进程管理和服务自愈能力的场景
• 对镜像体积和资源占用有严格要求的环境
• 作为基础镜像用于构建自定义应用镜像

使用方法

基本使用

通过docker run命令直接运行镜像：

bash
docker run --rm -it your-image-name sh

集成到自定义镜像

在Dockerfile中以本镜像为基础构建自定义应用：

dockerfile
FROM your-image-name

# 安装应用依赖
RUN apk add --no-cache your-package

# 添加S6服务配置
COPY ./services /etc/s6-overlay/s6-rc.d/

# 设置启动命令（S6 Overlay会自动处理）
CMD ["/init"]

S6服务配置示例

创建服务配置目录结构（以my-service为例）：

/etc/s6-overlay/s6-rc.d/
└── my-service
    ├── dependencies.d  # 依赖服务配置（可选）
    ├── run             # 服务启动脚本
    └── finish          # 服务停止脚本（可选）

run脚本示例：

bash
#!/command/execlineb -P
exec /path/to/your/service --option1 --option2

环境变量

S6 Overlay支持通过环境变量调整行为，常用变量包括：

• S6_KILL_GRACETIME：进程停止 grace 时间（默认：3000毫秒）
• S6_SERVICES_GRACETIME：服务停止 grace 时间（默认：3000毫秒）
• S6_CMD_WAIT_FOR_SERVICES_MAXTIME：等待服务启动的最大时间（默认：0，无限制）

致谢

• Alpine Linux：轻量级Linux发行版
• https://github.com/just-containers/s6-overlay%EF%BC%9A%E5%AE%B9%E5%99%A8%E8%BF%9B%E7%A8%8B%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7