crazymax/alpine-s6

镜像概述

crazy-max/alpine-s6 是一个基于 Alpine Linux 的轻量级基础镜像，集成了 s6 overlay 进程管理框架。该镜像旨在为容器化应用提供可靠的多进程管理能力，结合 Alpine Linux 的极小体积与 s6 overlay 的强大进程生命周期管理功能，适用于构建需要运行多个服务或进程的容器环境。

核心功能与特性

• 轻量级基础：基于 Alpine Linux，保持极小的镜像体积（通常小于10MB）和资源占用
• s6 进程管理：集成 s6 overlay 框架，提供进程监控、自动重启、优雅关闭等完整生命周期管理
• 多进程支持：原生支持在单个容器中运行多个服务进程，无需额外进程管理工具
• 灵活服务配置：通过 s6-rc 系统支持简单的服务定义和依赖管理，配置文件结构清晰
• 日志管理：内置日志处理机制，支持日志重定向至标准输出或文件存储
• Alpine 兼容性：完全兼容 Alpine Linux 包管理系统，可直接使用 apk 命令安装依赖

使用场景与适用范围

• 需要在单个容器中运行多个协同服务的应用（如 Web 服务+数据库、API 服务+缓存等）
• 轻量级微服务部署，适用于资源受限环境或边缘计算场景
• 开发/测试环境中快速搭建多组件依赖的应用栈
• 需要可靠进程管理的容器化应用，确保服务异常退出后自动恢复

使用方法

拉取镜像

bash
docker pull crazy-max/alpine-s6

基本运行示例

启动交互式容器验证基本功能：

bash
docker run --rm -it crazy-max/alpine-s6 sh

配置自定义服务

通过 s6 overlay 配置服务需在 /etc/s6-overlay/s6-rc.d/ 目录下定义服务单元：

1. 创建服务目录（以 my-service 为例）：

   bash
   mkdir -p /etc/s6-overlay/s6-rc.d/my-service
   

2. 编写启动脚本（run 文件）：

   bash
   cat > /etc/s6-overlay/s6-rc.d/my-service/run << 'EOF'
   #!/command/execlineb -P
   exec /path/to/your/service --config /etc/service.conf
   EOF
   chmod +x /etc/s6-overlay/s6-rc.d/my-service/run
   

3. （可选）编写停止脚本（finish 文件）：

   bash
   cat > /etc/s6-overlay/s6-rc.d/my-service/finish << 'EOF'
   #!/command/execlineb -P
   echo "Service stopped with exit code $1"
   EOF
   chmod +x /etc/s6-overlay/s6-rc.d/my-service/finish
   

4. 启用服务（创建符号链接至服务启用目录）：

   bash
   ln -s /etc/s6-overlay/s6-rc.d/my-service /etc/s6-overlay/s6-rc.d/user/contents.d/
   

Docker Compose 示例

yaml
version: '3.8'

services:
  app:
    image: crazy-max/alpine-s6
    volumes:
      - ./services:/etc/s6-overlay/s6-rc.d  # 挂载自定义服务配置
      - ./logs:/var/log/s6  # 挂载日志目录（当 S6_LOGGING=2 时）
    environment:
      - S6_LOGGING=1  # 日志输出至标准输出（0=禁用，1=标准输出，2=文件）
      - S6_KILL_GRACETIME=3000  # 进程终止等待时间（毫秒）
    restart: unless-stopped

配置参数

环境变量

卷挂载点

参考资料

• 官方 GitHub 仓库：https://github.com/crazy-max/docker-alpine-s6
• s6 overlay 官方文档：https://github.com/just-containers/s6-overlay
• Alpine Linux 文档：[***]