crazymax/alpine-s6-dist

docker-alpine-s6 镜像文档

一、镜像概述和主要用途

概述

docker-alpine-s6 是一个基于 Alpine Linux 的 Docker 镜像，集成了 s6 overlay 工具集。s6 overlay 是一套轻量级的进程管理解决方案，基于 s6 supervision suite，提供可靠的进程监控、生命周期管理和多进程协调能力。

主要用途

• 作为基础镜像，构建需要多进程管理的应用容器
• 提供进程监控与自动恢复能力，确保服务稳定运行
• 简化容器内多服务协同（如 Web 服务+数据库、应用+日志收集器等场景）
• 替代传统 init 系统，提供更细粒度的进程控制

二、核心功能和特性

1. s6 supervision suite 集成
   完整集成 s6-rc、s6-svscan、s6-supervise 等工具，实现进程的启动、监控、重启和优雅终止。

2. 多进程管理
   支持同时运行多个独立服务，每个服务通过独立的 supervision 配置进行管理。

3. 进程生命周期控制

   • 自动重启崩溃的进程（可配置重启策略）
   • 支持预启动（up）、启动（run）、停止（finish）、关闭（down）阶段的钩子脚本
   • 可配置进程终止的 grace time（优雅停止等待时间）

4. 轻量级基础
   基于 Alpine Linux，镜像体积小，资源占用低，适合生产环境部署。

5. 灵活的日志处理
   默认将服务日志转发至 stdout/stderr（符合 Docker 最佳实践），支持通过 s6-log 自定义日志路径和轮转策略。

6. 环境变量配置
   通过环境变量快速调整 s6 行为，无需修改底层配置文件。

三、使用场景和适用范围

适用场景

• 多服务容器：需在单个容器内运行多个协同服务（如 Nginx + PHP-FPM、Node.js + Redis）
• 进程监控需求：应用需要崩溃自动恢复、异常退出告警的场景
• 自定义基础镜像：为微服务构建统一的进程管理底座
• 替代 systemd/sysvinit：在轻量级环境中提供更可靠的 init 系统

不适用场景

• 仅需运行单进程的简单应用（建议直接使用官方基础镜像，避免资源浪费）
• 依赖 systemd 特性的应用（Alpine 通常不支持 systemd）

四、使用方法和配置说明

4.1 基础使用（作为基础镜像）

Dockerfile 示例

dockerfile
# 基于 docker-alpine-s6 构建自定义镜像
FROM crazy-max/alpine-s6:latest

# 安装应用依赖
RUN apk add --no-cache nginx php81-fpm

# 添加服务配置（s6 服务定义）
# Nginx 服务
RUN mkdir -p /etc/s6/services/nginx
COPY nginx.run /etc/s6/services/nginx/run
RUN chmod +x /etc/s6/services/nginx/run

# PHP-FPM 服务
RUN mkdir -p /etc/s6/services/php-fpm
COPY php-fpm.run /etc/s6/services/php-fpm/run
RUN chmod +x /etc/s6/services/php-fpm/run

# 暴露端口
EXPOSE 80

# 启动 s6-svscan（镜像已内置入口点，无需额外 CMD）

服务定义文件示例（如 nginx.run）：

sh
#!/bin/sh
# 必须使用 exec 启动进程，确保 s6 能正确监控主进程
exec nginx -g "daemon off;"

4.2 直接运行示例（docker run）

bash
# 运行包含 Nginx + PHP-FPM 的示例容器
docker run -d \
  --name alpine-s6-demo \
  -p 80:80 \
  -v $(pwd)/services:/etc/s6/services \  # 挂载本地服务配置
  -e S6_CMD_WAIT_FOR_SERVICES=1 \       # 等待所有服务启动完成
  crazy-max/alpine-s6:latest

4.3 docker-compose 配置示例

yaml
version: '3.8'

services:
  app:
    image: crazy-max/alpine-s6:latest
    container_name: alpine-s6-app
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./services:/etc/s6/services  # 自定义服务配置
      - ./logs:/var/log/app          # 日志持久化
    environment:
      - S6_CMD_WAIT_FOR_SERVICES=1
      - S6_KILL_GRACETIME=5000       # 进程终止等待时间 5 秒
      - S6_LOGGING=info              # 日志级别
    restart: unless-stopped

五、配置参数详解

5.1 环境变量

5.2 文件配置

服务定义目录

所有服务配置文件需放置在 /etc/s6/services/ 目录下，每个服务对应一个子目录（如 /etc/s6/services/nginx/）。每个服务目录需包含以下文件（至少包含 run）：

• run：必选，服务启动脚本，需使用 exec 命令启动进程（如 exec nginx -g "daemon off;"）
• finish：可选，服务停止后执行的清理脚本（如日志归档）
• down：可选，服务关闭前执行的脚本（如发送停止信号）
• type：可选，服务类型（longrun 长期运行服务，oneshot 一次性任务），默认 longrun
• timeout-up：可选，服务启动超时时间（秒），默认 0（无超时）

六、注意事项

1. 服务脚本权限：确保 /etc/s6/services/ 下的 run 等脚本具有可执行权限（chmod +x）。
2. 进程前台运行：服务必须以前台模式运行（如 Nginx 的 daemon off;），避免后台进程导致 s6 误判服务退出。
3. 信号处理：通过 exec 启动进程可确保 s6 正确接收和转发信号（如 SIGTERM）。
4. 日志最佳实践：默认日志输出到 stdout/stderr，可通过 s6-log 工具配置自定义日志路径（如 /var/log/app）。
5. Alpine 兼容性：依赖 musl libc，部分 glibc 程序可能需要额外配置。

七、参考链接

• 完整文档：https://github.com/crazy-max/docker-alpine-s6
• s6 supervision suite：s6 官方文档
• Alpine Linux：Alpine 官方网站