cilium/affinity-test-apps

affinity-test-apps 镜像文档

镜像概述和主要用途

affinity-test-apps 是一个包含客户端和服务器的测试应用程序，主要用于在 Kubernetes 服务端点发生变化时验证连接亲和性。服务器通过唯一 ID（如主机名）响应客户端请求，客户端则持续验证后续请求中服务器返回的 ID 是否保持一致，从而测试负载均衡的亲和性表现。

容器镜像可从 Docker Hub 获取：https://hub.docker.com/r/cilium/affinity-test-apps%E3%80%82

核心功能和特性

• 双组件架构：包含服务器和客户端应用，可独立部署和运行
• 唯一 ID 响应：服务器以自身唯一 ID（如主机名）作为响应内容
• 亲和性验证：客户端持续发送请求并验证服务器返回 ID 的一致性
• Kubernetes 兼容：适用于 Kubernetes 环境下服务端点变化场景的亲和性测试

使用场景和适用范围

• Kubernetes 环境中负载均衡亲和性策略的功能验证
• 服务端点动态变化（如扩缩容、滚动更新）时的连接稳定性测试
• 网络策略或服务配置调整后亲和性表现的验证
• 负载均衡器（如 Service、Ingress）亲和性机制的功能测试

使用方法和配置说明

获取镜像

bash
docker pull cilium/affinity-test-apps

运行服务器

服务器默认监听请求并返回自身唯一 ID（主机名）：

bash
docker run -d --name affinity-test-server cilium/affinity-test-apps server

运行客户端

客户端需指定服务器地址，持续发送请求并验证返回 ID 的一致性：

bash
docker run --rm cilium/affinity-test-apps client --server <服务器地址>

Kubernetes 部署示例

服务器 Deployment：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: affinity-test-server
spec:
  replicas: 3
  selector:
    matchLabels:
      app: affinity-test-server
  template:
    metadata:
      labels:
        app: affinity-test-server
    spec:
      containers:
      - name: server
        image: cilium/affinity-test-apps
        command: ["server"]
        ports:
        - containerPort: 8080

服务器 Service：

yaml
apiVersion: v1
kind: Service
metadata:
  name: affinity-test-service
spec:
  selector:
    app: affinity-test-server
  ports:
  - port: 80
    targetPort: 8080

客户端测试 Pod：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: affinity-test-client
spec:
  containers:
  - name: client
    image: cilium/affinity-test-apps
    command: ["client", "--server", "affinity-test-service"]

验证亲和性

客户端运行后，将输出每次请求的服务器 ID。若负载均衡亲和性配置正确，客户端应持续收到同一服务器 ID；若发生端点变化或亲和性失效，客户端将检测到 ID 变化并输出提示。