tutum/http-tap

http-tap

镜像概述

http-tap是一个用于暂停和恢复HTTP连接的工具，旨在支持零停机部署和数据库模式迁移。其设计灵感来源于文章《How Balanced does Database Migrations with Zero-Downtime》。该镜像可监听前端HTTP请求并转发至后端服务器，同时提供暂停/恢复连接的功能，确保在进行 schema 迁移等操作时不会导致服务中断。

核心功能和特性

• 连接控制：支持暂停所有传入的HTTP连接，阻止请求到达后端
• 连接恢复：可恢复已暂停的HTTP连接，使请求继续正常转发
• 请求转发：将前端接收到的HTTP请求转发至指定的后端服务器
• 轻量部署：通过Docker容器化部署，配置简单，易于集成到现有系统

使用场景和适用范围

• 零停机数据库迁移：在执行需要修改数据库schema的迁移操作时，暂停流量以避免新旧代码版本对数据结构的不一致访问
• 系统升级：在后端服务升级过程中，临时暂停请求转发，待升级完成后恢复流量
• 维护窗口：需要短时间停止服务处理但不想让客户端看到错误的场景

使用方法和配置说明

环境变量配置

启动容器

使用以下命令启动http-tap容器：

bash
docker run -d --name tap \
  -e FRONTEND_BIND="0.0.0.0:80" \
  -e BACKEND_SERVER="127.0.0.1:8000" \
  --net host \
  tutum/http-tap

参数说明：

• -d：后台运行容器
• --name tap：指定容器名称为"tap"
• -e：设置环境变量
• --net host：使用主机网络模式，使容器可直接访问主机网络接口

启动后，容器将在http://0.0.0.0:80监听HTTP请求，并转发至http://127.0.0.1:8000。

暂停连接

执行以下命令暂停所有HTTP连接：

bash
docker exec tap pause

恢复连接

执行以下命令恢复已暂停的HTTP连接：

bash
docker exec tap resume