nimmis/ubuntu

nimmis/ubuntu Docker镜像文档

镜像概述和主要用途

nimmis/ubuntu是基于不同Ubuntu LTS版本构建的Docker镜像，集成了工作的初始化(init)进程和syslog服务。该镜像解决了标准Ubuntu镜像中进程无法正确接收SIGTERM信号导致无法正常关闭的问题，通过supervisor进程管理工具实现服务的启动、监控和优雅关闭，适用于需要在容器中运行多个服务、定时任务或需要日志管理的场景。

核心功能和特性

工作的Init进程

• 集成my_init初始化脚本，基于Phusion的init脚本修改，使用supervisor管理进程
• 正确处理docker stop命令发送的SIGTERM信号，确保所有进程优雅关闭

自动时区设置

• 若容器可访问互联网，将自动根据IP地址确定并设置正确时区
• 支持通过环境变量或命令手动设置时区

启动脚本管理

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

服务和工具集成

• cron守护进程：默认运行cron服务，支持定时任务，配合logrotate防止日志文件过大
• syslog-ng：提供系统日志服务，所有syslog消息保存于/var/log/syslog
• 常用命令：预装wget、curl、zip/unzip、git、vim、nano、psmisc、less、patch、software-properties-common等常用工具

日志管理

• 容器启动时自动显示/tmp/startup.log内容，可通过docker logs <容器ID>查看
• 支持将任意命令输出追加到/var/log/startup.log以记录到docker日志

进程管理

• 通过supervisor管理服务，支持添加自定义服务配置
• 提供/my_service命令解决后台服务进程的监控问题

使用场景和适用范围

• 需要在单个容器中运行多个服务的应用场景
• 要求进程能够优雅关闭的生产环境
• 需要定时任务(cron)支持的应用
• 需要系统日志(syslog)记录的服务
• 作为基础镜像构建需要常用工具的应用容器

使用方法和配置说明

基本运行

后台运行

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

交互式运行（验证服务启动）

bash
docker run -ti nimmis/ubuntu

成功运行后将显示类似以下输出：

 open logfile
 Run files in /etc/my_runonce/
 Run files in /etc/my_runalways/
 Running /etc/rc.local...
 Booting supervisor daemon...
 Supervisor started as PID 11
2015-01-02 10:45:43,750 CRIT Set uid to user 0
 Started processes via Supervisor......
crond                            RUNNING    pid 15, uptime 0:00:02
syslog-ng                        RUNNING    pid 14, uptime 0:00:02

进入容器

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

重启容器

bash
docker start <容器ID>

设置时区

启动时设置时区

通过TIMEZONE环境变量指定：

bash
docker run -d -e TIMEZONE=Europe/Stockholm nimmis/ubuntu

在运行中设置时区

bash
docker exec -ti <容器ID> set_tz Europe/Stockholm

查看可用时区

bash
docker run --rm nimmis/ubuntu set_tz list

添加自定义服务

通过在/etc/supervisor/conf.d/目录添加.conf文件定义服务，示例配置（/etc/supervisor/conf.d/myprogram.conf）：

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

服务日志位于/var/log/supervisor/目录，文件命名格式为<服务名>-stdout|stderr-supervisor*.log

管理后台服务

对于需要后台运行的服务（如通过/etc/init.d/脚本管理的服务），使用/my_service命令：

1. 确保服务有标准的start/stop命令：

   bash
   /etc/init.d/myprogram start
   /etc/init.d/myprogram stop
   

2. 创建supervisor配置文件：

   ini
   [program:myprogram]
   command=/my_service myprogram
   

3. 可选：指定服务启动后执行的脚本

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

日志输出到Docker日志

将命令输出追加到/var/log/startup.log：

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

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

查看日志：

bash
docker logs <容器ID>

镜像标签

已弃用版本（EOL - 不建议使用）

问题反馈

如有任何问题或疑问，请通过https://github.com/nimmis/docker-ubuntu/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%8C%85%E5%90%AB%E4%BB%A5%E4%B8%8B%E4%BF%A1%E6%81%AF%EF%BC%9A

• 容器内cat /etc/BUILDS/的输出
• 相关日志信息
• 容器启动命令（包含参数、环境变量、挂载卷等）
• 其他有助于问题定位的信息

贡献

欢迎提交新功能、修复或更新，我们鼓励并快速处理Pull Request。