bretfisher/httpenv

镜像概述

本镜像是一个基于 Go 语言构建的轻量级 HTTP 服务器。其核心功能是接收 HTTP 请求，并以 JSON 格式返回当前容器运行时的所有环境变量。该镜像体积极小、启动迅速，专为云原生环境下的配置验证、环境变量调试以及 Mock 服务而设计。

核心功能与特性

• 极简设计：使用 Go 语言静态编译，无额外系统依赖，镜像体积微小。
• 结构化输出：将环境变量自动转换为标准的 JSON 格式，便于程序解析和人工阅读。
• 快速启动：极低的资源占用和毫秒级的冷启动时间，适合 Serverless 或弹性伸缩场景。
• 安全只读：仅提供环境变量的读取接口，不执行任何文件系统写操作，安全性高。

使用场景

• CI/CD 流水线调试：验证构建或部署阶段注入的环境变量是否符合预期。
• Kubernetes/Docker 配置验证：检查 ConfigMap、Secret 或 env 配置是否成功挂载并正确注入到容器中。
• API 网关与代理测试：作为后端 Mock 服务，测试请求头、环境变量透传或负载均衡功能。

使用方法

端口与路由说明

服务器默认监听 8080 端口。访问根路径 / 即可获取 JSON 格式的环境变量列表。

Docker Run 部署

使用 docker run 快速启动容器，并注入自定义环境变量进行测试：

bash
docker run -d \
  --name env-json-server \
  -p 8080:8080 \
  -e APP_NAME="MyApplication" \
  -e APP_ENV="production" \
  -e DB_HOST="localhost" \
  tiny-go-env-json:latest

验证输出：

bash
curl -s http://localhost:8080/ | jq

Docker Compose 部署

在 docker-compose.yml 中配置服务，适用于本地开发或集成测试环境：

yaml
version: '3.8'

services:
  env-server:
    image: tiny-go-env-json:latest
    container_name: env-json-server
    ports:
      - "8080:8080"
    environment:
      - APP_NAME=MyApplication
      - APP_ENV=production
      - DB_HOST=db.internal
      - DB_PORT=5432
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

响应示例

向该服务发起 HTTP GET 请求后，返回的 JSON 数据示例如下：

json
{
  "APP_ENV": "production",
  "APP_NAME": "MyApplication",
  "DB_HOST": "db.internal",
  "DB_PORT": "5432",
  "HOME": "/root",
  "HOSTNAME": "a1b2c3d4e5f6",
  "PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
}

注意：返回的 JSON 中不仅包含用户自定义注入的环境变量，还会包含容器操作系统默认提供的基础环境变量（如 PATH、HOSTNAME 等）。请在实际使用时根据具体的 Key 进行数据过滤。