simonkrenger/echoenv

echoenv 镜像文档

镜像概述

echoenv 是一个轻量级容器镜像，在8080端口运行HTTP服务，用于返回容器的环境变量、HTTP请求信息、主机名及进程元数据。该镜像设计简洁，主要用于调试和测试环境，帮助开发者快速验证环境配置、请求路由及容器运行状态。

核心功能和特性

• 环境变量展示：返回容器内所有环境变量列表（如PATH、HOSTNAME、PORT等）
• 请求信息捕获：包含HTTP请求方法、URL、协议、请求头（如Accept、User-Agent）及完整URL结构
• 系统元数据：提供客户端IP、容器主机名、进程ID（PID）、用户ID（UID）及组ID（GID）
• 轻量级设计：镜像体积小，启动快速，无额外依赖

使用场景

• 调试容器环境变量配置是否正确
• 测试HTTP请求路由及参数传递
• 验证容器网络连接（如客户端IP获取）
• 检查容器内进程运行状态（PID、UID/GID）
• Kubernetes或容器编排环境中的服务连通性测试

使用方法和配置说明

基本运行（Docker/Podman）

通过Docker或Podman运行容器，映射8080端口到主机：

bash
# 使用Docker运行
docker run -d -p 8080:8080 quay.io/simonkrenger/echoenv

# 或使用Podman运行
podman run -d -p 8080:8080 quay.io/simonkrenger/echoenv

运行后，通过curl或浏览器访问http://localhost:8080/<任意路径>即可获取JSON格式的响应，例如：

bash
curl localhost:8080/test | jq

响应示例包含以下关键信息：

• clientIP：客户端IP地址
• env：容器内环境变量列表
• hostname：容器主机名
• process：进程信息（GID、PID、UID）
• request：请求详情（方法、URL、头信息等）

Kubernetes Pod部署

可通过Kubernetes Pod部署，用于集群内调试：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: echoenv-pod
  labels:
    app: echoenv
spec:
  containers:
  - name: echoenv
    image: quay.io/simonkrenger/echoenv:latest
    ports:
    - containerPort: 8080  # 容器内暴露8080端口

部署后可通过kubectl port-forward访问：

bash
kubectl port-forward pod/echoenv-pod 8080:8080
curl localhost:8080

配置说明

• 端口映射：容器默认监听8080端口，需通过-p <主机端口>:8080映射到主机
• 环境变量：可通过-e参数添加自定义环境变量，这些变量会在响应的env字段中显示
• 镜像版本：推荐使用latest标签，或指定具体版本（如quay.io/simonkrenger/echoenv:v1.0）

响应字段说明

响应JSON的主要字段解释：

• env：容器内所有环境变量的键值对列表
• request.method：HTTP请求方法（如GET、POST）
• request.url：请求的URL详细信息（路径、查询参数等）
• request.header：请求头信息（如User-Agent、Accept）
• process：容器内运行进程的ID及权限信息（PID、UID、GID）