adockero/events-script

docker-events-script镜像说明

镜像概述

docker-events-script镜像能够监听Docker事件（如网络连接、容器创建等），并触发预先配置的脚本执行，常用于自动重载Nginx配置等容器管理场景，可替代docker-gen工具实现自动化操作。

核心功能

1. 监听Docker事件（支持通过参数过滤事件类型）
2. 执行自定义脚本（如容器操作、服务重启等）
3. 支持通过ini配置文件定义事件与脚本的关联规则
4. 提供默认Nginx重载配置，开箱即用

使用场景

• 容器网络变化时自动重载Nginx配置
• 容器创建/销毁时触发相关服务更新
• 自定义Docker事件驱动的自动化操作

配置说明

启动容器

简单使用（默认监听网络连接事件并重启Nginx）：

bash
docker run --restart=always -d --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name events-script \
  adockero/events-script 

测试验证

触发网络事件测试：

bash
docker run -i --rm --network host nginx ls

一键组合测试（常规）：

bash
docker rm -f events-script || \
docker run --restart=always -d --privileged -v /var/run/docker.sock:/var/run/docker.sock --name events-script adockero/events-script && \
docker run -i --rm --network host nginx ls && \
docker logs events-script && \
docker rm -f events-script

一键组合测试（带镜像拉取）：

bash
docker rm -f events-script || \
docker pull adockero/events-script && \
docker run --restart=always -d --privileged -v /var/run/docker.sock:/var/run/docker.sock --name events-script adockero/events-script && \
docker run -i --rm --network host nginx ls && \
docker logs events-script && \
docker rm -f events-script

查看执行日志

bash
docker logs -f events-script

自定义事件脚本

通过docker-scripts/events-script.ini配置文件定义事件规则： 默认Nginx重载配置示例：

ini
[nginxReload]
args='-f "type=network" -f "event=connect"'
command='sleep 2 && docker exec -i nginx nginx -t && docker exec -i nginx nginx -s reload'

自定义规则要求：

1. 配置头（如[test]）需为无空格英文
2. 仅支持args（Docker事件过滤参数）和command（触发执行的脚本）两个参数
3. command可包含多个命令（用&&分隔），支持Docker命令
4. 若需等待容器就绪，可添加sleep延迟

其他说明

若遇到无法重启等问题，可前往GitHub仓库提交https://github.com/aogg/docker-events-script/issues%E5%8F%8D%E9%A6%88%E3%80%82