debug-app 镜像文档

镜像概述和主要用途

debug-app 是一个用于在Kubernetes环境中以Pod形式运行的调试应用。它设计用于帮助用户在Kubernetes集群中进行调试、测试及验证集群功能，如调度策略、网络连接和服务暴露等场景。

核心功能和特性

• Kubernetes原生部署：支持通过Kubernetes Deployment和Service资源进行部署，与Kubernetes集群无缝集成。
• 服务暴露能力：可通过Service资源暴露内部端口，实现集群内外访问。
• Pod反亲和性配置：内置Pod反亲和性规则，优先避免同一节点运行多个debug-app Pod，优化节点资源分布。
• 可配置副本数：支持通过Deployment的replicas字段灵活调整运行的Pod数量。

使用场景和适用范围

• Kubernetes集群调试：验证集群调度策略、节点资源分配是否符合预期。
• 网络连通性测试：通过Service暴露端口，测试集群内部服务间通信或外部访问集群服务的能力。
• 部署配置验证：作为示例应用验证Kubernetes资源配置（如亲和性规则、端口映射）的正确性。

使用方法和配置说明

部署示例

以下是完整的Kubernetes部署配置，包含Service和Deployment资源定义：

---
apiVersion: v1
kind: Service
metadata:
  name: debug-app
  namespace: default
  labels:
    app: debug-app
spec:
  selector:
    app: debug-app
  ports:
  - name: app-port
    port: 80  # Service暴露的端口
    targetPort: 8080  # 映射到Pod的容器端口
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: debug-app
  namespace: default
  labels:
    app: debug-app
spec:
  replicas: 6  # 运行的Pod副本数
  selector:
    matchLabels:
      app: debug-app
  template:
    metadata:
      labels:
        app: debug-app
    spec:
      containers:
      - name: debug-app
        imagePullPolicy: Always  # 始终拉取最新镜像
        image: pietervogelaar/debug-app:latest  # 镜像地址
        ports:
        - containerPort: 8080  # 容器内部监听端口
      affinity:
        podAntiAffinity:
          # 优先避免同一节点运行多个debug-app Pod
          preferredDuringSchedulingIgnoredDuringExecution:
          - podAffinityTerm:
              labelSelector:
                matchExpressions:
                - key: app
                  operator: In
                  values:
                  - debug-app
              topologyKey: kubernetes.io/hostname  # 基于主机名的拓扑键
            weight: 100  # 调度优先级权重

关键配置参数说明

• Deployment配置：

  • replicas: 6：指定部署6个Pod副本，可根据需求调整数量。
  • imagePullPolicy: Always：确保每次部署时拉取最新镜像。
  • containerPort: 8080：容器内部监听端口，需与Service的targetPort对应。

• Service配置：

  • port: 80：Service对外暴露的端口，供集群内其他服务或外部访问。
  • targetPort: 8080：将流量转发到Pod的8080端口。

• Pod亲和性配置：

  • podAntiAffinity：通过preferredDuringSchedulingIgnoredDuringExecution设置软策略，优先避免同一节点运行多个debug-app Pod，topologyKey: kubernetes.io/hostname基于节点主机名进行调度限制，weight: 100表示该策略的优先级权重。

部署步骤

1. 将上述YAML配置保存为debug-app-deploy.yaml。
2. 使用kubectl apply -f debug-app-deploy.yaml命令在Kubernetes集群中部署。
3. 部署完成后，可通过kubectl get pods -l app=debug-app查看运行的Pod，通过kubectl get svc debug-app查看Service状态。