sc4h/alpine-s6overlay

docker-alpine-s6overlay

镜像概述

docker-alpine-s6overlay 是一个基于 Alpine Linux 的轻量级基础镜像，集成了 s6-overlay 进程管理框架。该镜像旨在为容器化应用提供可靠的进程监督、服务生命周期管理和优雅的启动/关闭机制，特别适合需要管理多个进程或依赖特定启动顺序的应用场景。

Alpine Linux 的轻量级特性（小巧的镜像体积、高效的资源占用）与 s6-overlay 的强大进程管理能力相结合，使该镜像成为构建精简且可靠的容器服务的理想基础。

核心功能与特性

1. 轻量级基础

• 基于官方 Alpine Linux 镜像构建，继承其小巧体积（通常小于 10MB 基础层）和高效资源利用率。
• 采用 Alpine 的包管理系统（apk），支持快速安装额外依赖。

2. s6-overlay 进程管理

• 集成最新版 s6-overlay，提供轻量级 init 系统功能，替代传统的 sysvinit 或 systemd。
• 进程监督：自动监控指定服务进程，在进程意外退出时自动重启（可配置策略）。
• 生命周期管理：支持服务的启动顺序控制（通过 dependencies 配置）、预启动/后停止脚本执行。
• 优雅关闭：接收容器停止信号（如 SIGTERM）后，按优先级逐步终止服务，确保数据一致性。
• 多进程支持：原生支持管理容器内多个进程，无需额外依赖 supervisord 等工具。

3. 易用性与灵活性

• 简化的服务定义：通过在 /etc/s6-overlay/s6-rc.d/ 目录下放置服务配置文件，即可定义需管理的服务。
• 环境变量驱动配置：支持通过环境变量自定义 s6-overlay 行为（如超时时间、日志级别等）。
• 兼容标准容器实践：支持 Docker 官方的健康检查、日志驱动等功能。

使用场景与适用范围

• 多进程容器：需在单个容器内运行多个协同服务（如应用服务器 + 数据库代理）。
• 服务依赖管理：应用启动前需先启动依赖服务（如先启动数据库再启动应用）。
• 优雅启停需求：需确保服务在容器停止时完成数据持久化、连接清理等操作。
• 微服务基础镜像：作为微服务的基础层，统一进程管理逻辑，简化服务部署配置。
• 开发/测试环境：快速构建包含完整依赖服务的本地开发环境。

使用方法与配置说明

1. 获取镜像

通过 Docker 命令直接拉取（需替换 TAG 为具体版本，如 3.18-s6v3.1.5.0）：

bash
docker pull gitlab.com/sc4h/docker-alpine-s6overlay:TAG

或在 Dockerfile 中作为基础镜像引用：

dockerfile
FROM gitlab.com/sc4h/docker-alpine-s6overlay:TAG

2. 基本使用流程

步骤 1：定义服务

在镜像或容器中，通过以下方式定义 s6-overlay 管理的服务：

1. 在 /etc/s6-overlay/s6-rc.d/ 目录下创建服务目录（如 my-service）。
2. 在服务目录中创建必要文件：
   • run：服务启动脚本（必须可执行，退出时服务将被视为停止）。
   • finish（可选）：服务停止后执行的清理脚本。
   • dependencies（可选）：指定依赖的其他服务（需先启动的服务名称）。

示例服务定义（以 nginx 为例）：

bash
# 创建服务目录
mkdir -p /etc/s6-overlay/s6-rc.d/nginx

# 编写 run 脚本（启动 nginx 并保持前台运行）
cat > /etc/s6-overlay/s6-rc.d/nginx/run << 'EOF'
#!/command/execlineb -P
nginx -g "daemon off;"
EOF

# 添加执行权限
chmod +x /etc/s6-overlay/s6-rc.d/nginx/run

步骤 2：构建自定义镜像（可选）

基于 docker-alpine-s6overlay 构建包含应用的自定义镜像：

dockerfile
FROM gitlab.com/sc4h/docker-alpine-s6overlay:3.18-s6v3.1.5.0

# 安装应用依赖（如 nginx）
RUN apk add --no-cache nginx

# 添加服务配置（如上述 nginx 服务定义）
COPY ./nginx-service /etc/s6-overlay/s6-rc.d/nginx

# 暴露端口（如 nginx 的 80 端口）
EXPOSE 80

步骤 3：运行容器

直接运行基础镜像（需挂载服务配置）：

bash
docker run -d \
  --name my-service \
  -v $(pwd)/my-service:/etc/s6-overlay/s6-rc.d/my-service \
  gitlab.com/sc4h/docker-alpine-s6overlay:latest

运行自定义镜像：

bash
docker run -d \
  --name my-nginx \
  -p 80:80 \
  my-custom-nginx-image:latest

配置参数与环境变量

s6-overlay 的行为可通过环境变量自定义，常用配置如下：

Docker Compose 示例

以下是使用 docker-compose.yml 部署基于该镜像的多服务应用示例（包含 nginx 和 php-fpm）：

yaml
version: '3.8'

services:
  web:
    build: .  # 基于 docker-alpine-s6overlay 构建的自定义镜像
    ports:
      - "80:80"
    volumes:
      - ./html:/var/www/html
    environment:
      - S6_KILL_GRACETIME=60  # 延长优雅关闭等待时间
      - S6_LOGGING=2  # 同时输出日志到文件和标准输出
    restart: unless-stopped

注意事项

• 服务定义权限：确保 /etc/s6-overlay/s6-rc.d/ 下的服务脚本（run、finish）具有可执行权限（chmod +x）。
• 前台运行要求：服务的 run 脚本必须以前台模式运行进程（如 nginx -g "daemon off;"），否则 s6-overlay 会认为进程已退出并尝试重启。
• 日志管理：默认日志输出到标准输出，建议结合 Docker 的日志驱动（如 json-file、journald）进行日志收集。
• 镜像标签：建议使用具体版本标签（如 3.18-s6v3.1.5.0）而非 latest，确保构建一致性。

参考链接

• https://github.com/just-containers/s6-overlay
• Alpine Linux 官方网站
• 镜像源码仓库