imeq/whoami

imeq/whoami 镜像文档

镜像概述

imeq/whoami是一个轻量级HTTP服务镜像，运行后会在指定端口提供HTTP接口，返回包含实例ID（instance）、版本号（version）和时间戳（time）的JSON格式响应。该镜像设计简洁，无需复杂配置，可快速部署用于各类测试和演示场景。

核心功能与特性

• 基础响应：默认返回包含instance（随机整数）、version（默认"1.0"）和time（当前时间戳）的JSON数据
• 环境变量自定义：支持通过VERSION和INSTANCE环境变量自定义响应中的版本号和实例ID
• 轻量级：镜像体积小，启动速度快，资源占用低
• 开箱即用：无需额外配置文件，通过简单命令即可运行

使用场景

• 容器网络测试：验证端口映射、网络连通性
• 服务演示：展示HTTP服务基本响应格式和环境变量配置
• 开发调试：作为临时后端服务，模拟API响应
• 容器编排测试：验证环境变量传递和容器启动参数配置

使用方法

基本运行

通过以下命令启动容器，映射80端口并交互式运行：

bash
docker run --rm -it -p 80:80 imeq/whoami

访问http://localhost:80，将返回类似以下JSON响应：

json
{
  "instance": 665730,
  "version": "1.0",
  "time": 1650613164
}

自定义响应值

通过-e参数设置环境变量，自定义version和instance值：

bash
docker run --rm -it -e VERSION='2.0' -e INSTANCE=10 -p 80:80 imeq/whoami

此时访问http://localhost:80，响应将变为：

json
{
  "instance": 10,
  "version": "2.0",
  "time": 1650613164
}

环境变量说明

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  whoami:
    image: imeq/whoami
    ports:
      - "8080:80"  # 映射到主机8080端口
    environment:
      - VERSION=3.0
      - INSTANCE=100
    restart: always

使用以下命令启动服务：

bash
docker-compose up -d