nimmis/alpine

基于Alpine的微容器（含init进程、syslog和cron）

![]([***]

镜像概述

这是一个非常小巧的容器（51 Mb），但包含完整的init进程、crond和syslog服务。本镜像设计为所有其他微容器的基础镜像，解决了Docker容器中进程管理和信号处理的常见问题。

核心功能与特性

完善的init进程管理

• 采用修改版的my_init脚本（基于Phusion的init脚本，适配supervisor而非runit）作为PID 1进程
• 能够接收并处理docker stop发送的SIGTERM信号，确保所有子进程优雅关闭
• 通过supervisor系统管理后台服务

启动脚本机制

• 一次性启动脚本目录：/etc/my_runonce
  目录中的所有可执行文件在容器首次启动时运行，执行完成后自动删除
• 每次启动脚本目录：/etc/my_runalways
  目录中的所有可执行文件在每次容器启动（docker run和docker start）时运行

日志管理

• 启动日志输出：容器启动时自动显示/tmp/startup.log内容，可通过docker logs <容器ID>随时查看
• syslog服务：内置rsyslogd，所有syslog消息保存于/var/log/syslog
• 日志轮转：集成logrotate防止日志文件过大

定时任务支持

• 内置crond服务，满足周期性任务需求

Docker环境优化

• 针对Docker容器内运行Linux的特殊场景进行了额外修复

使用场景

• 作为需要进程管理、日志记录或定时任务的应用的基础镜像
• 构建需要优雅关闭功能的微服务容器
• 开发环境中需要轻量级但功能完整的Linux环境

使用方法与配置说明

基本运行

后台运行（推荐）

bash
docker run -d --name alpine nimmis/alpine

交互式运行（测试用）

bash
docker run -ti nimmis/alpine

成功运行后将显示：

*** open logfile
*** Run files in /etc/my_runonce/
*** Run files in /etc/my_runalways/
*** Booting supervisor daemon...
*** Supervisor started as PID 7
2015-01-02 10:45:43,750 CRIT Set uid to user 0
crond[10]: crond (busybox 1.24.1) started, log level 8
*** Started processes via Supervisor......
crond                            RUNNING    pid 10, uptime 0:00:04
rsyslogd                         RUNNING    pid 11, uptime 0:00:04

容器管理

停止容器

bash
docker stop <容器ID>

停止时将显示：

*** Shutting down supervisor daemon (PID 7)...
*** Killing all processes...

重启容器

bash
docker start <容器ID>

进入容器shell

bash
docker exec -ti <容器ID> /bin/sh

添加自动启动服务

通过supervisor添加自动启动服务：

1. 在/etc/supervisor.d/目录下创建以.conf结尾的配置文件（如/etc/supervisor.d/myprogram.conf）
2. 配置文件格式：

ini
[program:myprogram]
command=/usr/bin/myprogram

• myprogram：进程名称（用于supervisctl管理）
• 日志文件位于/var/log/supervisor/，格式为<进程名>-stdout|stderr-supervisor*.log

更多配置选项参见supervisor官方文档

管理后台服务

对于需要后台运行的服务（如/etc/init.d/中的服务），使用my_service命令：

1. 确保服务可通过以下命令启动/停止：

bash
/etc/init.d/command start  # 启动
/etc/init.d/command stop   # 停止
# 或
service command start
service command stop

2. 创建supervisor配置文件：

ini
[program:myprogram]
command=/my_service myprogram

3. （可选）添加启动后执行脚本：

ini
[program:myprogram]
command=/my_service myprogram /usr/local/bin/postproc.sh

其中/usr/local/bin/postproc.sh为服务启动后执行的脚本

输出信息到Docker日志

要将信息输出到docker logs，需将内容追加到/var/log/startup.log：

bash
# 输出文本
echo "应用启动完成" >> /var/log/startup.log

# 输出脚本结果
/usr/local/bin/myscript >> /var/log/startup.log

示例：

bash
docker exec alpine sh -c 'echo "测试日志消息" >> /var/log/startup.log'
docker logs alpine  # 将显示包含"*** Log: 测试日志消息"的内容

镜像标签

本镜像提供多个Alpine版本标签，格式为nimmis/alpine:<tag>：