jonoh/compose-up

compose-up 镜像文档

镜像概述

compose-up 是一个轻量级容器镜像，核心功能是在接收到 HTTP 请求时执行预设命令。该镜像内置 docker-compose 工具，便于在容器环境中直接管理多容器应用的编排与运行。

核心功能与特性

• HTTP 触发机制：通过接收 HTTP 请求自动触发命令执行
• 内置工具集成：包含 docker-compose，支持多容器应用的配置与管理
• 简化操作流程：无需手动登录容器，通过 HTTP 请求即可远程触发命令

使用场景

• 远程触发 docker-compose 命令（如启动、停止或重启多容器应用）
• 构建简单的 webhook 服务，响应外部事件并执行预设操作
• 自动化部署流程中作为触发节点，接收部署信号后执行部署命令

使用方法

基本运行示例

bash
docker run -d -p 80:80 --name compose-up-instance docker.xuanyuan.run/compose-up

端口映射说明

默认情况下，容器监听 80 端口接收 HTTP 请求，建议通过 -p 参数映射到主机端口（如上述示例中的 -p 80:80）。

触发命令执行

向容器的 HTTP 服务发送请求即可触发命令执行：

bash
# 向本地运行的容器发送请求
curl http://localhost:80

# 向远程服务器上的容器发送请求
curl http://<服务器IP>:<映射端口>

自定义命令配置

（注：具体自定义命令的配置方式需参考镜像完整文档，基础版本可能通过环境变量或启动命令参数指定待执行命令）

注意事项

• 确保容器具有足够的权限执行所需命令（必要时可添加 --privileged 参数）
• 生产环境中建议添加身份验证机制，避免未授权的 HTTP 请求触发命令执行
• 若需持久化 docker-compose 配置文件，可通过 -v 参数挂载主机目录到容器内相应路径