ikubernetes/demoapp

Kubernetes演示应用镜像

镜像概述

本镜像为《Kubernetes进阶实战(第2版)》配套使用的应用镜像，主要用于Kubernetes学习、演示和实践场景，提供了多个API端点和可配置参数，帮助用户理解容器化应用在Kubernetes环境中的部署与运行机制。

核心功能与特性

v1.x版本

命令格式

• 默认监听地址与端口：0.0.0.0:80
• 支持参数：
  • -p|--port <port>：指定监听端口
  • -v：显示版本信息
  • -h|--host <ADDRESS>：指定监听地址

可用URL

• GET /：根路径请求
• GET /hostname：获取主机名
• GET /user-agent：获取客户端User-Agent信息
• GET /configs：获取配置信息
• GET 和 POST /livez：存活探针接口，POST请求可接收livez参数
• GET 和 POST /readyz：就绪探针接口，POST请求可接收readyz参数

环境变量

• DEPLOYENV：部署环境信息
• RELEASE：发布版本信息
• HOST：监听地址，默认值为0.0.0.0
• PORT：监听端口，默认值为80

v2.x版本

改动提示：新增支持通过环境变量VERSION定义程序版本号，扩展了功能和配置项。

命令格式

• 默认监听地址与端口：0.0.0.0:80
• 支持参数：
  • -p|--port <port>：指定监听端口
  • -v：显示版本信息
  • -l|--host <ADDRESS>：指定监听地址（参数名由v1.x的-h|--host调整为-l|--host）

可用URL

• 包含v1.x所有URL，并新增：
  • GET /api/get_service：获取服务信息接口

环境变量

• 包含v1.x所有环境变量，并新增：
  • VERSION：自定义应用版本号
  • APP_NAME：服务名称

使用场景与适用范围

• Kubernetes初学者学习容器化应用部署与配置
• 演示Kubernetes探针（存活探针、就绪探针）功能
• 测试环境中模拟微服务应用行为
• 《Kubernetes进阶实战(第2版)》书籍配套实验

使用方法与配置说明

部署示例

Docker Run命令（v1.x）

bash
docker run -d -p 8080:80 \
  -e DEPLOYENV=dev \
  -e RELEASE=v1.0.0 \
  --name k8s-demo-app-v1 \
  [镜像名称]:v1.x

Docker Run命令（v2.x）

bash
docker run -d -p 8080:80 \
  -e DEPLOYENV=prod \
  -e RELEASE=v2.1.0 \
  -e VERSION=2.1.0 \
  -e APP_NAME=k8s-demo-service \
  --name k8s-demo-app-v2 \
  [镜像名称]:v2.x

Docker Compose配置示例（v2.x）

yaml
version: '3'
services:
  k8s-demo-app:
    image: docker.xuanyuan.run/[镜像名称]:v2.x
    ports:
      - "8080:80"
    environment:
      - DEPLOYENV=test
      - RELEASE=v2.0.0
      - VERSION=2.0.0
      - APP_NAME=demo-service
      - HOST=0.0.0.0
      - PORT=80
    restart: always

配置说明

• 端口映射：建议将容器内80端口映射到宿主机的自定义端口（如8080），便于访问
• 环境变量配置：根据实际需求设置DEPLOYENV、RELEASE、VERSION等环境变量，自定义应用行为
• 探针使用：可通过/livez和/readyz接口配置Kubernetes的存活探针和就绪探针，确保应用健康检查

注意事项

• v1.x与v2.x版本的命令参数存在差异（监听地址参数由-h|--host调整为-l|--host），使用时需注意版本匹配
• 环境变量HOST和PORT若未指定，将使用默认值0.0.0.0和80

马哥教育 倾情制作~