cilium/graceful-termination-test-apps

graceful-termination-test-apps 镜像文档

镜像概述

graceful-termination-test-apps是一个包含客户端和服务器应用的Docker镜像，专门用于测试当服务器关闭时客户端到服务器连接的优雅终止机制。当服务器优雅终止时，客户端会以状态码0正常退出；若终止过程失败，客户端则会发生panic以指示异常情况。该镜像可从Docker Hub获取：https://hub.docker.com/r/cilium/graceful-termination-test-apps%E3%80%82

核心功能与特性

• 连接终止测试：提供客户端和服务器组件，用于模拟和验证连接终止场景
• 结果状态指示：客户端通过退出状态码明确指示终止结果（0表示成功，非0表示失败）
• 异常处理：连接终止失败时客户端会触发panic，便于快速识别问题
• 轻量集成：同时包含客户端和服务器应用，可直接用于端到端测试

使用场景与适用范围

• 开发环境中验证应用程序对连接优雅终止的处理逻辑
• 测试服务器关闭流程中客户端连接的清理机制
• 容器化环境下验证服务终止时的连接管理策略
• 网络协议实现中连接终止机制的正确性测试

使用方法与配置说明

获取镜像

通过Docker Hub拉取最新镜像：

bash
docker pull docker.xuanyuan.run/cilium/graceful-termination-test-apps

运行服务器

启动服务器组件（默认监听8080端口）：

bash
docker run --rm -d --name graceful-termination-server docker.xuanyuan.run/cilium/graceful-termination-test-apps server

运行客户端

连接到正在运行的服务器进行测试：

bash
docker run --rm --link graceful-termination-server:server docker.xuanyuan.run/cilium/graceful-termination-test-apps client --server server:8080

测试优雅终止流程

1. 启动服务器容器：

   bash
   docker run --rm -d --name graceful-termination-server docker.xuanyuan.run/cilium/graceful-termination-test-apps server
   

2. 启动客户端容器连接到服务器：

   bash
   docker run --rm --link graceful-termination-server:server docker.xuanyuan.run/cilium/graceful-termination-test-apps client --server server:8080
   

3. 优雅停止服务器容器：

   bash
   docker stop graceful-termination-server
   

4. 检查客户端退出状态码（0表示优雅终止成功）：

   bash
   echo $?  # 输出应为0
   

失败场景测试

若服务器非优雅终止（如强制终止），客户端将发生panic：

1. 启动服务器和客户端（同上步骤1-2）

2. 强制终止服务器：

   bash
   docker kill graceful-termination-server
   

3. 查看客户端容器日志确认panic信息：

   bash
   docker logs <client-container-id>