klokantech/supervisord

Supervisord Docker镜像

镜像概述

本镜像基于Debian stable构建，集成了Supervisor进程控制系统，用于启动和管理多个进程。通过派生此镜像并添加自定义配置文件，可实现对应用服务的统一进程管理，支持环境变量动态配置及集中式日志管理。

核心功能与特性

• 稳定基础：基于Debian stable发行版，提供可靠的运行环境
• 进程管理：集成Supervisor，支持多进程的启动、监控和自动重启
• 环境变量扩展：配置文件中支持通过%(ENV_VARIABLE)语法引用环境变量
• 日志集中：所有进程日志统一写入/var/log/supervisord/目录，便于管理和排查

使用场景

• 需在单个容器中运行多个协同服务的场景
• 需要通过环境变量动态调整服务配置的应用部署
• 微服务架构中需统一管理多个组件进程的场景
• 要求进程崩溃后自动恢复的应用环境

使用方法与配置说明

派生镜像配置

在派生镜像时，需将服务的Supervisor配置文件复制到/etc/supervisord/conf.d/目录（配置文件通常以.conf为扩展名）。

示例配置文件（如myapp.conf）：

ini
[program:myapp]
command=/usr/local/bin/myapp --port=%(ENV_APP_PORT)s  ; 使用环境变量
autostart=true          ; 容器启动时自动启动服务
autorestart=true        ; 服务退出时自动重启
stdout_logfile=/var/log/supervisord/myapp.log  ; 标准输出日志路径
stderr_logfile=/var/log/supervisord/myapp.err.log  ; 错误输出日志路径
user=appuser            ; 运行服务的用户

环境变量使用

通过docker run或docker-compose设置环境变量，配置文件中使用%(ENV_环境变量名)s引用。例如：

• 容器启动时设置APP_PORT=8080
• 配置文件中%(ENV_APP_PORT)s会被替换为8080

日志管理

Supervisor及所有受管理进程的日志默认存储在/var/log/supervisord/目录。建议通过挂载卷持久化日志：

bash
docker run -v /宿主机日志路径:/var/log/supervisord 镜像名

部署示例

Docker Run 命令

bash
docker run -d \
  --name my-supervisord \
  -e APP_PORT=8080 \                      # 设置环境变量
  -e DB_HOST=db.example.com \
  -v /本地配置目录:/etc/supervisord/conf.d \  # 挂载配置文件目录
  -v /本地日志目录:/var/log/supervisord \    # 挂载日志目录
  my-supervisord-image                       # 派生的镜像名

Docker Compose 配置

yaml
version: '3.8'
services:
  supervisord:
    build: .  # 或使用已构建的镜像名
    container_name: my-supervisord
    environment:
      - APP_PORT=8080
      - DB_HOST=db.example.com
    volumes:
      - ./conf.d:/etc/supervisord/conf.d  # 本地配置目录映射
      - ./logs:/var/log/supervisord       # 本地日志目录映射
    restart: always  # 容器退出时自动重启