nbrown/nginxhello

标签及对应的 Dockerfile 链接

• https://github.com/nbrownuk/docker-nginxhello/blob/mainline/Dockerfile

镜像概述和主要用途

此镜像是https://nginx.org/en/ HTTP服务器的简单配置，主要用于演示从Docker主机上运行的容器、Swarm集群中的服务任务或Kubernetes集群中的Pod提供服务的能力。通过环境变量配置，可实现不同的显示效果，同时提供基础的健康检查机制。

核心功能和特性

• 简化的Nginx配置：基础HTTP服务配置，便于快速部署和演示
• 环境变量定制：
  • COLOR：设置显示颜色，支持Red、Blue、Black（默认值）
  • NODE_NAME：添加主机名到服务内容，增强节点标识
• 健康检查端点：
  • 存活检查：/healthz/live
  • 就绪检查：/healthz/ready

使用场景和适用范围

• Docker主机上的容器服务演示与测试
• Swarm集群中服务任务的部署与发现验证
• Kubernetes集群中Pod的服务提供与节点信息展示
• 容器健康检查机制的功能验证

使用方法和配置说明

运行容器

基本启动

Nginx配置简单，可通过以下命令快速启动：

bash
$ docker container run --rm -d -p 80:80 -e COLOR=blue nbrown/nginxhello

显示主机名

要在服务内容中添加Docker主机的主机名，设置NODE_NAME环境变量：

bash
$ docker container run --rm -d -p 80:80 -e NODE_NAME=$(hostname) nbrown/nginxhello

运行Swarm服务

在Swarm集群中部署服务，让每个任务显示其调度节点的主机名：

bash
$ docker service create --detach=false \
    --publish published=80,target=80 \
    --env COLOR=Red \
    --env NODE_NAME="{{.Node.Hostname}}" \
    nbrown/nginxhello

运行Kubernetes部署

创建Deployment，使副本显示所在集群节点的主机名（使用Downward API获取节点信息）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: nginxhello
  name: nginxhello
spec:
  selector:
    matchLabels:
      app: nginxhello
  template:
    metadata:
      labels:
        app: nginxhello
    spec:
      containers:
      - image: nginxhello
        name: nginxhello
        ports:
        - containerPort: 80
        env:
        - name: NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName