ikerry/kube-app

ikerry/kube-app 镜像说明

镜像概述

本镜像包含一个针对Kubernetes环境的测试应用程序，提供多种API接口以验证集群中的应用行为、监控指标采集及外部云服务（如AWS S3）的集成能力，适用于Kubernetes集群的功能测试与验证场景。

核心功能

• 指标暴露：通过/metrics接口返回Prometheus兼容的Node.js指标数据
• 健康检查：/health接口返回应用健康状态
• 错误模拟：提供/api/v1/500、/api/v1/504等接口模拟不同HTTP错误码
• 超时测试：/api/v1/timeout/<$timeout>接口根据参数模拟请求超时
• 大响应测试：/api/v1/largeresp接口返回大体积响应数据
• AWS S3操作：支持列出桶、创建/删除桶、上传/删除对象等S3相关操作

使用场景

1. Kubernetes集群中应用部署与运行状态验证
2. Prometheus监控系统集成测试
3. 应用错误处理逻辑与超时机制验证
4. 云存储服务（AWS S3）集成能力测试

配置说明

若需使用S3相关功能，需配置以下环境变量：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥
• AWS_REGION：AWS区域（默认：us-east-1）

部署示例

Docker Run命令

bash
docker run -d -p 3000:3000 \
  -e AWS_ACCESS_KEY_ID=your-access-key \
  -e AWS_SECRET_ACCESS_KEY=your-secret-key \
  -e AWS_REGION=cn-north-1 \
  ikerry/kube-app

Docker Compose示例

yaml
version: '3'
services:
  kube-app:
    image: ikerry/kube-app
    ports:
      - "3000:3000"
    environment:
      - AWS_ACCESS_KEY_ID=your-access-key
      - AWS_SECRET_ACCESS_KEY=your-secret-key
      - AWS_REGION=cn-north-1

参考链接

• https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html
• Express应用安全最佳实践
• Express生产环境最佳实践
• https://expressjs.com/en/advanced/best-practice-performance.html