chruth/alpine-base

Alpine-base 镜像文档

概述

Alpine-base是一个基于Alpine Linux的基础Docker镜像，集成了s6-overlay进程管理工具。该镜像旨在为构建需要可靠进程管理的Docker容器提供轻量级、安全的基础环境，适用于作为各类应用的底层支撑镜像。

核心功能与特性

• 轻量级基础：基于Alpine Linux，保持极小的镜像体积和高效的资源占用
• 进程管理：集成s6-overlay工具集，提供以下核心能力：
  • 进程监控与自动重启
  • 优雅的服务启动/停止流程
  • 信号处理与进程生命周期管理
  • 多进程容器支持
• 兼容性：完全兼容Alpine Linux生态，可直接使用apk包管理工具扩展功能

使用场景

• 构建需要运行多个协同进程的容器化应用
• 开发需要可靠进程监控与自动恢复机制的服务
• 作为其他应用镜像的基础层，简化进程管理配置
• 构建轻量级且安全的生产环境容器

使用方法与配置说明

基本使用

通过以下命令可直接运行基础镜像：

bash
docker run --rm chruth/alpine-base

构建自定义镜像

通常作为基础镜像用于构建其他应用，示例Dockerfile：

dockerfile
# 基于alpine-base构建自定义应用镜像
FROM chruth/alpine-base

# 添加应用服务配置（s6-overlay服务定义）
COPY my-app-service /etc/services.d/my-app/run
RUN chmod +x /etc/services.d/my-app/run

# 安装应用依赖（可选）
RUN apk add --no-cache my-app-dependency

# 设置工作目录（可选）
WORKDIR /app

# 添加应用代码
COPY . /app

服务配置说明

s6-overlay通过服务目录管理进程，标准服务配置结构：

/etc/services.d/
  └── <service-name>/
       ├── run        # 服务启动脚本（必须）
       └── finish     # 服务停止清理脚本（可选）

run脚本示例（启动一个简单的HTTP服务）：

bash
#!/usr/bin/execlineb -P
nginx -g "daemon off;"

高级配置

• 环境变量：支持通过环境变量调整s6-overlay行为，常见变量包括：
  • S6_KILL_GRACETIME：进程终止等待时间（默认3000毫秒）
  • S6_SERVICES_GRACETIME：服务停止等待时间（默认5000毫秒）
• 日志管理：默认将服务输出重定向至stdout/stderr，可通过修改服务脚本自定义日志路径

相关资源

• 项目源码：https://github.com/chruth/alpine-base
• s6-overlay文档：https://github.com/just-containers/s6-overlay
• Alpine Linux文档：[***]