ogajun/stub-container

Stub容器

镜像概述和主要用途

Stub容器是一个轻量级工具，用于在部署实际应用前创建ECS服务的存根实例。它提供基础的服务模拟功能，帮助开发者和运维人员在正式部署前验证服务配置、网络连通性及依赖关系。

核心功能和特性

• 可达性测试：支持检查到任意主机和端口的TCP连接状态
• HTTPS支持：可通过自签名证书提供HTTPS服务
• 自定义响应：响应内容包含配置的应用名称，便于识别服务实例

可达性测试

Stub容器提供网络连通性测试功能，通过访问特定端点可验证容器与目标主机的TCP连接状态。使用格式为/nettest/<host>/<port>的端点，其中<host>为目标主机名或IP，<port>为目标端口。

HTTPS支持

默认情况下容器使用HTTP协议，当设置环境变量LISTEN_HTTPS=true时，将自动切换为HTTPS模式并使用自签名证书提供加密服务。

使用场景和适用范围

• ECS服务部署前的配置验证
• 网络策略和安全组规则测试
• 服务依赖关系验证
• 负载均衡器健康检查模拟
• CI/CD流程中的服务可用性测试

使用方法和配置说明

环境变量配置

基本使用流程

1. 构建镜像

bash
$ docker build -t stub_container .

2. 运行HTTP服务

bash
$ docker run -e LISTEN_PORT=3000 -e APP_NAME=0gajun -p 3000:3000 stub_container

服务启动后监听3000端口，可通过以下命令验证：

bash
$ curl http://localhost:3000
stub container for 0gajun service

3. 运行HTTPS服务

bash
$ docker run -e LISTEN_HTTPS=true -e LISTEN_PORT=3000 -e APP_NAME=0gajun -p 3000:3000 stub_container

由于使用自签名证书，curl需添加-k参数忽略证书验证：

bash
$ curl -k https://localhost:3000
stub container for 0gajun service

网络可达性测试示例

检查到github.com:443的TCP连接：

bash
$ curl http://localhost:3000/nettest/github.com/443
Successfully established tcp connection to github.com:443

检查到example.com:80的TCP连接：

bash
$ curl http://localhost:3000/nettest/example.com/80
Successfully established tcp connection to example.com:80