socrata/runit-focal 镜像文档

镜像概述

socrata/runit-focal 是一个基于 phusion/baseimage-docker 的 Docker 基础镜像，旨在为构建其他容器提供标准化的模式和工具集。该镜像以 Ubuntu 20.04 LTS 为基础系统，核心特性是通过 runit 实现多进程管理，并预装 OpenJDK 8，适用于需要运行多个服务或依赖 Java 环境的应用场景。

核心功能和特性

基础系统与进程管理

• Ubuntu 20.04 LTS：稳定的基础操作系统环境
• my_init 进程管理：提供正确的 init 进程，支持：
  • 进程收割（process reaping）
  • Docker Stop 发送 SIGTERM 信号至 init 进程，实现所有进程优雅终止
• runit 服务管理：替代 Ubuntu 原生 Upstart，用于服务监控和生命周期管理

系统工具与服务

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

扩展功能

• envconsul 内置：基于 Consul K/V 键值对创建环境变量（参见 [***]
• ark-host/ark-hostname 路由：通过 /etc/host 路由实现容器对 Docker 主机的感知，默认使用默认路由 IP，可配置，设置环境变量 ARK_HOST 和 ARK_HOSTNAME
• env_parse 工具：从 jinja 模板和环境变量生成配置文件，支持模板变量从环境变量取值，语法为 env_parse <模板文件> [输出文件]，若省略输出文件则默认去除模板文件的 .j2 后缀作为输出文件名

使用场景和适用范围

适用于作为基础镜像构建需要多进程管理、日志轮转、环境变量配置的服务容器，尤其适合依赖 OpenJDK 8 运行环境的 Java 应用，或需要通过 Consul 管理配置的微服务场景。

使用方法和配置说明

启动流程

1. 初始化脚本：/etc/my_init.d 目录下的脚本会在容器启动时按字典顺序执行，若任一脚本返回非零 exit code，容器将终止
2. 服务管理：默认运行 /etc/service 目录下通过 runit 定义的服务，每个服务需包含 run 脚本（服务启动逻辑）和可选的 log 脚本（日志处理逻辑）

服务定义规范

• run 脚本：必须为可执行文件，使用 exec 启动服务进程，建议通过 setuser 指定运行用户，示例：

  sh
  #!/bin/sh
  exec /sbin/setuser <用户名> <服务命令>
  

• log 脚本：可选，用于配置日志处理，推荐使用 svlogd 管理日志，示例：

  sh
  #!/bin/sh
  exec svlogd -tt /var/log/<服务名>
  

部署示例

Dockerfile 示例

dockerfile
FROM socrata/runit-focal

# 创建服务目录
RUN mkdir /etc/service/myservice
# 复制服务启动脚本
COPY myservice-run /etc/service/myservice/run
# 复制日志处理脚本
COPY myservice-log /etc/service/myservice/log
# 赋予执行权限
RUN chmod +x /etc/service/myservice/run /etc/service/myservice/log

服务脚本示例

• myservice-run（服务启动脚本）：

  sh
  #!/bin/sh
  exec /sbin/setuser socrata /path/to/your/service/binary
  

• myservice-log（日志处理脚本）：

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

构建与运行

bash
# 构建镜像
docker build -t awesome_sauce .
# 运行容器
docker run -d awesome_sauce