kodekloud/ecommerce

镜像概述

该镜像为一个示例Web应用，专门设计用于演示和学习Kubernetes中的Ingress功能。通过部署此应用，用户可以直观了解Ingress资源如何定义外部访问集群服务的路由规则，包括路径匹配、主机名路由等核心功能。

核心功能与特性

• 基础HTTP服务：提供简单的HTTP响应能力，支持基本的Web访问测试
• Ingress规则演示：兼容各类Ingress控制器（如NGINX、Traefik等），可验证路径路由、主机匹配等规则
• 轻量级设计：镜像体积小，部署快速，适合测试环境使用
• 请求元数据展示：可返回请求路径、来源IP等信息，便于验证Ingress配置效果

使用场景

• Kubernetes Ingress概念学习与实践
• Ingress控制器功能验证与调试
• 多路径、多主机路由规则测试
• 开发环境中快速搭建Ingress演示环境
• 网络策略与外部访问控制教学

使用方法与配置说明

Docker本地运行

可直接通过Docker运行以测试基本功能：

bash
docker run -d -p 8080:80 --name ingress-demo-app sample-ingress-app:latest

访问 http://localhost:8080 可查看应用默认页面，确认服务正常运行。

Kubernetes部署示例

1. 部署应用（Deployment）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-demo-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: ingress-demo
  template:
    metadata:
      labels:
        app: ingress-demo
    spec:
      containers:
      - name: ingress-demo-app
        image: sample-ingress-app:latest
        ports:
        - containerPort: 80

2. 创建服务（Service）

yaml
apiVersion: v1
kind: Service
metadata:
  name: ingress-demo-service
spec:
  selector:
    app: ingress-demo
  ports:
  - port: 80
    targetPort: 80
  type: ClusterIP

3. 配置Ingress规则

以下示例演示路径路由功能（需提前部署Ingress控制器，如NGINX Ingress Controller）：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-demo-rule
spec:
  ingressClassName: nginx  # 需与集群中的Ingress控制器类名匹配
  rules:
  - http:
      paths:
      - path: /ingress-demo
        pathType: Prefix
        backend:
          service:
            name: ingress-demo-service
            port:
              number: 80

部署后，通过Ingress控制器的外部IP访问 http://<ingress-controller-ip>/ingress-demo 即可验证路由效果。

环境变量配置

应用支持通过环境变量调整基本行为：

• PORT: 应用监听端口（默认：80）
• RESPONSE_MESSAGE: 自定义响应消息（默认："Ingress Demo App - Request received"）
• SHOW_REQUEST_DETAILS: 是否显示请求详情（默认：true，显示路径、方法、来源IP等）

示例：修改响应消息

yaml
# 在Deployment的container中添加环境变量
env:
- name: RESPONSE_MESSAGE
  value: "Custom message from Ingress demo"