socrata/runit-bionic 镜像文档

概述

socrata/runit-bionic是一个基于phusion/baseimage-docker构建的Docker镜像，以Ubuntu 18.04 LTS为基础系统，旨在为构建支持多进程的容器提供标准化的模式和工具集。该镜像通过runit实现服务的监控与管理，集成了多种系统级工具，满足日志处理、定时任务、服务启停等基础需求，适用于需要在容器中运行多个服务的场景。

核心功能与特性

基础系统

• Ubuntu 18.04 LTS：作为底层操作系统，提供稳定的运行环境。

进程管理

• my_init 初始化进程：提供正确的init系统，具备以下能力：
  • 进程回收：确保僵尸进程被及时清理
  • 优雅终止：Docker Stop命令会向init进程发送SIGTERM信号，进而优雅停止所有进程
• runit 服务管理器：替代Ubuntu原生的Upstart，用于服务的监控和生命周期管理

系统工具

• syslog-ng：日志守护进程，确保包括内核在内的多种服务能正确记录日志到/var/log/syslog
• logrotate：定期轮转并压缩日志文件，防止日志文件过大
• SSH服务器：默认禁用，可根据需求启用
• cron：定时任务守护进程，确保cron任务正常运行
• setuser：以指定用户身份运行命令的工具，比su更易用，比sudo***面更小，能正确设置$HOME环境变量，路径为/sbin/setuser

容器增强工具

• 主机信息环境变量：通过内置脚本生成ARK_HOST（主机IP）和ARK_HOSTNAME（主机名）环境变量，使容器能够感知宿主机信息
• env_parse：基于jinja模板和环境变量生成配置文件的工具，支持动态配置生成

使用场景

• 需要在单个容器中运行多个服务的应用部署
• 要求完善日志管理（轮转、压缩）的服务场景
• 需要定时任务（cron）支持的应用
• 需通过环境变量动态生成配置文件的服务
• 对服务启停、进程管理有严格要求的生产环境

使用方法

基础使用

该镜像默认运行/etc/service目录下定义的所有服务。容器启动时，/etc/my_init.d目录中的脚本会按字典序执行，若任一脚本返回非零退出码，容器将终止启动。

服务定义示例

以下是基于该镜像构建自定义服务的Dockerfile示例：

FROM socrata/runit-bionic

# 创建runit服务目录
RUN mkdir -p /etc/sv/myservice/log

# 复制服务启动脚本
COPY myservice-run /etc/sv/myservice/run
# 复制日志管理脚本
COPY myservice-log /etc/sv/myservice/log/run

# 赋予执行权限
RUN chmod +x /etc/sv/myservice/run /etc/sv/myservice/log/run

服务启动脚本（myservice-run）

使用setuser以指定用户运行服务：

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

日志管理脚本（myservice-log）

使用svlogd管理服务日志：

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

env_parse工具使用

env_parse用于从jinja模板和环境变量生成配置文件，语法格式如下：

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

• 模板文件：必须为jinja模板（通常以.j2为后缀），模板中的变量需对应环境变量
• 输出文件（可选）：若未指定，输出文件名为模板文件名去除尾部.j2（如app.conf.j2生成app.conf）

示例：

1. 创建jinja模板文件app.conf.j2：

[app]
name = {{ APP_NAME }}
port = {{ APP_PORT }}

2. 运行env_parse生成配置文件：

env_parse app.conf.j2

3. 若环境变量APP_NAME=myapp、APP_PORT=8080，将生成app.conf：

[app]
name = myapp
port = 8080