codegazers/colors

codegazers/colors镜像说明

镜像概述

codegazers/colors是一个轻量级Web服务镜像，支持通过环境变量自定义服务参数，提供文本访问和健康检查功能，适用于Docker服务部署测试、负载均衡演示等场景。

核心功能

1. 环境变量配置：支持COLOR（颜色定义）、HOSTNAME（替代主机名）、APPROOT（应用根URL）等参数设置；
2. 接口支持：提供/text文本访问接口和/health健康检查接口；
3. 状态控制：通过容器内创建/tmp/down文件可将应用状态从UP切换为DOWN；
4. 负载均衡适配：支持Docker EE Interlock负载均衡配置。

使用场景

• Docker服务部署测试；
• 负载均衡（如Docker EE Interlock）功能演示；
• 简单Web服务接口验证。

配置说明

环境变量

部署示例

简单运行（指定颜色）

bash
docker run -ti -e COLOR=white -p 8080:3000 codegazers/colors:1.19

Docker服务部署（随机颜色）

bash
docker service create --name colors \
    --publish target=3000,published=8000 \
    frjaraur/colors:VERSION

Docker EE Interlock负载均衡演示（Compose配置）

yaml
version: "3.3"
services:
  red:
    image: frjaraur/colors:1.4
    environment:
      - COLOR=red
    deploy:
      replicas: 1
      labels:
        com.docker.lb.hosts: red.example.com
        com.docker.lb.network: colors
        com.docker.lb.port: 3000
    networks:
      - colors
  blue:
    image: frjaraur/colors:1.4
    environment:
      - COLOR=blue
    deploy:
      replicas: 1
      labels:
        com.docker.lb.hosts: blue.example.com
        com.docker.lb.network: colors
        com.docker.lb.port: 3000
    networks:
      - colors
networks:
  colors:

接口访问I

• 访问文本接口：curl http://localhost:8000/text
• 健康检查：curl http://localhost:8000/health
• 切换应用状态：在容器内创建/tmp/down文件后，健康检查状态会变为DOWN。

bash
curl -vvv 0.0.0.0:8000/health