diff --git a/CHANGELOG.md b/CHANGELOG.md index a93ba13..06765fd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,7 @@ - 新增独立 `transport/http2` 实验 Runner:支持 h2c/TLS h2、连接上限、全局请求并发闸门、GOAWAY 排空、RST_STREAM 单流取消和生命周期统计;不改变 native HTTP/1.1 默认路径。 - HTTP/2 实验 Runner 增加标准 1 MiB 头部上限、默认 8 MiB 请求体上限、128 路同连接多路复用、2 MiB 慢读取流控验收、协议错误和 GOAWAY 计数;已声明超限请求在进入业务 handler 前返回 413。 - 新增可配置时长的 HTTP/2 TLS soak:默认 3 秒,Linux 验收可通过 `GO_OMNI_HTTP2_SOAK_DURATION=30m` 覆盖,混合验证 128 路 stream、慢 handler、请求体、Keep-Alive 和退出回收。 +- 新增 `scripts/verifyHTTP2.py`,固定在 Go 1.25 Linux 容器中运行 HTTP/2 TLS race 长测。 - native TLS 明确限制 ALPN 为 `http/1.1`:缺省自动宣告该协议,误配置 `h2` 等未实现协议时在启动阶段报错。 - native `Server.Stats()` 新增连接和请求过载拒绝计数;新增可信代理配置,访问日志只在 socket 对端属于配置网段时解析 `X-Forwarded-For`。 - 新增 transport-neutral `metrics` 包,支持请求数、错误数、in-flight、累计耗时和状态分布,并可直接注册 `/metrics` 接口。 diff --git a/ROADMAP.md b/ROADMAP.md index 6f5e061..c9f33ab 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -51,6 +51,7 @@ - native `Stats()` 已记录连接和请求过载拒绝数;访问日志已支持可信代理网段配置,默认拒绝伪造的 `X-Forwarded-For`。 - native TLS 已明确只宣告 HTTP/1.1 ALPN;HTTP/2 暂由边缘代理终止或使用 `transport/nethttp`,已整理独立协议设计、流控和压测门槛,见 [native HTTP/2 进入条件](transport/native/HTTP2.md),完成后再接入 native。 - 已加入独立 `transport/http2` 实验 Runner,验证 h2c/TLS h2、连接上限、全局请求并发拒绝和恢复,以及 GOAWAY 排空、RST_STREAM 单流取消和服务关闭超时;它使用 `x/net/http2` 作为临时帧/流控实现,尚未达到 native 生产协议的流控和长测门槛。 +- HTTP/2 实验已补齐头部/请求体上限、128 路同连接多路复用、慢读取流控、协议错误与 GOAWAY 统计,并提供 `scripts/verifyHTTP2.py --duration 30m` 的 Linux TLS 长测入口;RST_STREAM 独立计数、代理联调和长测结果仍是进入 native 前的门槛。 - 已用 16 个并发 worker 完成 3,200 次建连/断连 race 验收;MaxConnections 满载拒绝、槽位释放和 TLS 连接上限均已覆盖。 - 新增 `scripts/verifyLinux.py`,固定在 Go 1.25 Linux 容器内运行 race、vet、build 和可选 TLS/非 TLS perfcheck;perfcheck 记录堆、goroutine、连接和 Linux 文件描述符。 - Linux/arm64 已完成 30 秒、128 并发、512 空闲连接的 TLS 与非 TLS 持续回归,报告见 `performance/linuxSoak.json` 和 `performance/linuxSoakTLS.json`,均为 0 错误且连接、goroutine、FD 回收正常。 diff --git a/scripts/verifyHTTP2.py b/scripts/verifyHTTP2.py new file mode 100755 index 0000000..b1cc541 --- /dev/null +++ b/scripts/verifyHTTP2.py @@ -0,0 +1,41 @@ +#!/usr/bin/env python3 +"""Run the opt-in HTTP/2 TLS soak in a pinned Linux Go image.""" + +import argparse +from pathlib import Path +import shutil +import subprocess +import sys + + +def main() -> None: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--image", default="golang:1.25") + parser.add_argument("--duration", default="30m") + parser.add_argument("--gomaxprocs", type=int, default=2) + args = parser.parse_args() + if not args.duration or args.gomaxprocs < 1: + parser.error("--duration must be non-empty and --gomaxprocs must be positive") + + docker = shutil.which("docker") + if docker is None: + raise SystemExit("docker is required for HTTP/2 Linux soak") + root = Path(__file__).resolve().parent.parent + command = [ + docker, "run", "--rm", "--pull=missing", + "-v", f"{root}:/workspace", "-w", "/workspace", + "-e", "GOWORK=off", "-e", f"GOMAXPROCS={args.gomaxprocs}", + "-e", f"GO_OMNI_HTTP2_SOAK_DURATION={args.duration}", + args.image, "go", "test", "-race", "./transport/http2", + "-run", "^TestTLSSoak$", "-count=1", + ] + print(f"HTTP/2 Linux soak image: {args.image}", flush=True) + print(f"HTTP/2 TLS soak duration: {args.duration}", flush=True) + result = subprocess.run(command, cwd=root) + if result.returncode != 0: + raise SystemExit(f"HTTP/2 Linux soak failed with exit code {result.returncode}") + print("PASS HTTP/2 TLS soak", flush=True) + + +if __name__ == "__main__": + main() diff --git a/transport/native/HTTP2.md b/transport/native/HTTP2.md index ef9ee90..803df5f 100644 --- a/transport/native/HTTP2.md +++ b/transport/native/HTTP2.md @@ -2,7 +2,7 @@ 当前 `transport/native` 是经过 Linux 长连接和反向代理验收的 HTTP/1.1 实现。HTTP/2 暂不直接打开,原因是它把一个 TCP 连接变成多个独立请求流,连接级的 Keep-Alive、超时和并发限制不能直接复用现有 HTTP/1.1 状态机。 -当前已提供独立的 `transport/http2` 实验 Runner。它已经验证 TLS/h2、h2c、本地连接和请求闸门、GOAWAY 排空以及 RST_STREAM 取消;这些结果用于验证生命周期设计,不代表 native 已经启用 HTTP/2。实验 Runner 还覆盖了默认 1 MiB 头部上限、8 MiB 请求体上限、128 路同连接 stream 多路复用,以及 2 MiB 慢读取 body 在窗口耗尽后的恢复。`TestTLSSoak` 默认运行 3 秒,Linux 长测通过 `GO_OMNI_HTTP2_SOAK_DURATION=30m go test -race ./transport/http2 -run '^TestTLSSoak$'` 启动。 +当前已提供独立的 `transport/http2` 实验 Runner。它已经验证 TLS/h2、h2c、本地连接和请求闸门、GOAWAY 排空以及 RST_STREAM 取消;这些结果用于验证生命周期设计,不代表 native 已经启用 HTTP/2。实验 Runner 还覆盖了默认 1 MiB 头部上限、8 MiB 请求体上限、128 路同连接 stream 多路复用,以及 2 MiB 慢读取 body 在窗口耗尽后的恢复。`TestTLSSoak` 默认运行 3 秒,Linux 长测通过 `python3 scripts/verifyHTTP2.py --duration 30m` 启动。 ## 目标边界