socrata/runit-focal 镜像文档

镜像概述和主要用途

基于phusion/baseimage-docker构建的Docker基础镜像，以Ubuntu 20.04 LTS为系统基础，集成runit进程管理工具及一系列实用组件，旨在为构建支持多进程的容器提供标准化的模式和工具集。

核心功能和特性

• 基础系统：Ubuntu 20.04 LTS
• 初始化进程：my_init，具备以下特性：
  • 正确的进程回收机制
  • Docker Stop命令会向init进程发送SIGTERM信号，实现所有进程的优雅终止
• 进程管理：runit替代Ubuntu的Upstart，用于服务的监控和管理
• 日志管理：
  • syslog-ng：系统日志守护进程，确保服务（包括内核）可正确记录日志到/var/log/syslog
  • logrotate：定期轮转和压缩日志文件
• SSH服务：默认禁用
• 定时任务：cron守护进程，确保定时任务正常运行
• 用户切换工具：setuser，用于以其他用户身份运行命令，比su更易用，比sudo***面更小，比chpst能正确设置$HOME，路径为/sbin/setuser
• 环境变量工具：
  • 主机信息脚本：生成ARK_HOST和ARK_HOSTNAME环境变量，使容器能感知主机信息
  • env_parse：基于jinja模板和环境变量生成配置文件的工具，支持动态配置生成

使用场景和适用范围

适用于需要构建支持多进程管理、可靠日志处理、定时任务执行及动态配置生成的Docker容器场景，尤其适合作为复杂服务的基础镜像，如需要同时运行多个服务组件的应用容器。

使用方法和配置说明

启动脚本执行

容器启动时，/etc/my_init.d目录下的脚本会按字典顺序执行，执行于runit启动之前。任何脚本返回非零退出码将导致容器启动终止。

runit服务配置

基于此镜像构建的容器默认通过runit运行/etc/service目录下配置的服务。需为每个服务在/etc/service下创建子目录，并在其中放置run脚本（服务启动命令）和log/run脚本（日志处理命令）。

env_parse工具使用

用于从jinja模板和环境变量生成配置文件，语法为：

env_parse <模板文件> [输出文件]

• 模板文件需使用jinja语法，模板变量需作为环境变量存在
• 若省略输出文件，默认输出文件名为模板文件名去除末尾的.j2

部署示例

Dockerfile示例

构建一个名为awesome_sauce的镜像：

FROM socrata/runit-focal

RUN mkdir /etc/service/myservice
COPY myservice-run /etc/service/myservice/run
COPY myservice-log /etc/service/myservice/log/run

服务run脚本示例（/etc/service/myservice/run）

#!/bin/sh
exec /sbin/setuser socrata my_binary

日志run脚本示例（/etc/service/myservice/log/run）

#!/bin/sh
exec svlogd -tt /var/log/myservice