socrata/runit-bionic 镜像文档

镜像概述

socrata/runit-bionic 是基于 phusion/baseimage-docker 的 Docker 镜像，旨在为构建支持多进程的容器提供基础模式和工具集。该镜像以 Ubuntu 18.04 LTS 为基础系统，集成了 runit 进程管理工具，并预装 OpenJDK 8，适用于需要可靠进程管理和多服务运行的场景。

核心功能和特性

基础系统与进程管理

• Ubuntu 18.04 LTS：稳定的基础操作系统
• my_init 初始化进程：提供正确的 init 系统，具备：
  • 进程回收功能，确保僵尸进程被正确清理
  • 支持 Docker Stop 发送 SIGTERM 信号至 init 进程，实现所有进程的优雅终止
• runit 服务管理：替代 Ubuntu 原生 Upstart，用于服务的监控和管理

系统工具与服务

• APT 兼容性修复：解决 Docker 环境下 APT 的兼容性问题（详见 Docker Issue #1024）
• syslog-ng：系统日志守护进程，确保服务（包括内核）可正确记录日志至 /var/log/syslog
• logrotate：定期轮转和压缩日志文件，防止日志文件过大
• SSH 服务器：默认禁用，可根据需求启用
• cron 守护进程：确保定时任务正常运行
• setuser 工具：用于以指定用户身份运行命令，比 su 更易用，比 sudo ***面更小，且能正确设置 $HOME，路径为 /sbin/setuser

扩展工具

• envconsul：内置 envconsul，用于从 Consul K/V 对创建环境变量
• ark-host/ark-hostname 路由：提供 /etc/host 到 Docker 主机的路由（可配置，默认使用默认路由 IP），通过脚本创建 ARK_HOST 和 ARK_HOSTNAME 环境变量，使容器能感知主机信息
• env_parse：从 Jinja 模板和环境变量生成配置文件的工具。模板变量需以环境变量形式存在，支持指定输出文件（默认输出文件为模板文件名去除 .j2 后缀）

使用场景

适用于需要在单个容器中运行多个服务、要求可靠进程管理、日志处理和定时任务的场景，尤其适合 Java 应用（预装 OpenJDK 8）、需要从 Consul 获取配置的服务，以及依赖动态生成配置文件的应用。

使用方法和配置说明

基本运行机制

基于 socrata/runit-bionic 构建的容器默认运行 /etc/service 目录中配置的所有服务（通过 runit 管理）。/etc/my_init.d 目录中的脚本会在 runit 启动前按字典顺序执行，若任一脚本返回非零退出码，容器将停止启动。

服务配置示例

Dockerfile 示例

构建名为 awesome_sauce 的镜像：

FROM socrata/runit-bionic

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

runit 服务定义

run 脚本（服务启动脚本）：

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

（以 socrata 用户身份执行 my_binary）

log 脚本（日志管理脚本）：

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

（使用 svlogd 记录日志至 /var/log/myservice，-tt 选项添加时间戳）

关键目录说明

• /etc/service：存放 runit 服务定义，每个子目录为一个服务，包含 run（启动脚本）和 log（日志脚本）
• /etc/my_init.d：启动阶段执行的初始化脚本，按文件名字典顺序执行
• /var/log：日志存储目录，各服务日志通常存放于此（如示例中的 /var/log/myservice）