volumeClaimTemplates:
- metadata:
    name: data
  spec:
    accessModes: [ "ReadWriteOnce" ]
    storageClassName: "ssd"
    resources:
      requests:
        storage: 100Gi

# 指定使用的 API 版本为 apps/v1，这是 Kubernetes 中用于部署无状态应用的标准 API。
apiVersion: apps/v1

# 定义资源类型为 Deployment，表示这是一个用于管理 Pod 副本集的控制器。
kind: Deployment

# metadata 描述该 Deployment 的元数据信息。
metadata:
  # 给这个 Deployment 起一个名字：nginx-web。
  name: nginx-web

# spec 是 Deployment 的具体配置内容。
spec:
  # 设置副本数量为 3，即始终保证有 3 个运行中的 Pod。
  replicas: 3
  # selector 用于选择哪些 Pod 属于这个 Deployment 管理的范围。
  selector:
    matchLabels:
      # 匹配标签 app=nginx 的 Pod。
      app: nginx

  # template 是创建 Pod 的模板定义，Deployment 根据此模板来生成 Pod。
  template:
    # metadata 描述 Pod 的元数据。
    metadata:
      labels:
        # 所有由这个 Deployment 创建的 Pod 都带有标签 app=nginx。
        app: nginx

    # spec 是 Pod 的具体规格定义。
    spec:
      # containers 定义容器列表，这里只有一个容器。
      containers:
      - name: nginx
        # 使用的镜像名称和版本：nginx:1.23.1。
        image: nginx:1.23.1
        # 容器监听的端口，这里是 80。
        ports:
        - containerPort: 80

        # 资源限制设置（limits）：对容器能使用的最大 CPU 和内存进行限制。
        resources:
          limits:
            # 最多使用 0.5 个 CPU（即 500m CPU）。
            cpu: "0.5"
            # 最多使用 512Mi 内存。
            memory: "512Mi"

livenessProbe:  # 定义存活探针（liveness probe），用于判断容器是否健康并决定是否重启容器。
  httpGet:      # 使用 HTTP GET 请求方式进行健康检查。
    path: /     # 指定要访问的路径，默认是根路径 "/"。
    port: 80    # 指定服务监听的端口号，这里设置为 80 端口。
  initialDelaySeconds: 30  # 容器启动后等待 30 秒才开始执行第一次健康检查。
  periodSeconds: 10        # 每隔 10 秒执行一次健康检查。

readinessProbe:  # 定义就绪探针（readiness probe），用于判断容器是否准备好接收流量。
  httpGet:       # 同样使用 HTTP GET 请求方式进行健康检查。
    path: /      # 指定要访问的路径，默认是根路径 "/"。
    port: 80     # 指定服务监听的端口号，这里设置为 80 端口。
  initialDelaySeconds: 5   # 容器启动后等待 5 秒才开始执行第一次就绪检查。
  periodSeconds: 5         # 每隔 5 秒执行一次就绪检查。

strategy:  # 定义 Deployment 的更新策略，控制滚动更新的行为。
  type: RollingUpdate  # 指定使用“滚动更新”策略。即逐步替换旧版本 Pod，确保服务不中断。
  rollingUpdate:       # 配置 RollingUpdate 类型的具体参数。
    maxSurge: 25%      # 表示在更新过程中，最多可以超出期望副本数的 25%。  
                       # 举例：如果当前有 4 个 Pod，最多可以临时增加 1 个新 Pod（4 * 25% = 1），
                       # 用于保证扩容时系统资源充足、避免负载过高。
    maxUnavailable: 25% # 表示在更新过程中，最多允许 25% 的 Pod 不可用（即停止旧 Pod）。  
                        # 举例：如果有 4 个 Pod，最多允许 1 个 Pod 暂时不可用（4 * 25% = 1），
                        # 确保服务仍然有足够的副本提供访问能力。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-web
spec:
  replicas: 3  # 核心：副本数控制
  selector:    # Pod选择器
    matchLabels:
      app: nginx
  template:    # Pod模板（控制器据此创建Pod）
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.23.1
        ports:
        - containerPort: 80
        resources:
          limits:   # 资源约束
            cpu: "0.5"
            memory: "512Mi"

apiVersion: v1
kind: Service
metadata:
  creationTimestamp: null
  name: nginx-service
spec:
  ports:
  - port: 80
    protocol: TCP
    targetPort: 80
  selector:
    app: nginx
  type: NodePort
status:
  loadBalancer: {}

# 指定使用的 API 版本为 autoscaling/v2，这是 Kubernetes 中用于配置自动伸缩的标准 API。
apiVersion: autoscaling/v2

# 定义资源类型为 HorizontalPodAutoscaler，表示这是一个水平 Pod 自动伸缩器。
kind: HorizontalPodAutoscaler

# metadata 描述该 HPA 对象本身的元数据信息。
metadata:
  # 给这个 HorizontalPodAutoscaler 起一个名字：nginx-hpa。
  name: nginx-hpa

# spec 是该 HPA 的具体配置和行为定义。
spec:
  # scaleTargetRef 表示要自动伸缩的目标资源对象。
  scaleTargetRef:
    # 指定目标资源的 API 版本为 apps/v1，通常是 Deployment、ReplicaSet 等控制器。
    apiVersion: apps/v1
    # 指定目标资源的类型为 Deployment。
    kind: Deployment
    # 指定目标 Deployment 的名称是 nginx-web。
    name: nginx-web

  # 设置副本数量的最小值，即自动伸缩时最少保持 2 个 Pod。
  minReplicas: 2

  # 设置副本数量的最大值，即自动伸缩时最多扩展到 10 个 Pod。
  maxReplicas: 10

  # metrics 定义了触发自动伸缩的指标列表。
  metrics:
  - type: Resource  # 表示使用的是资源类型的指标（如 CPU、内存等）。
    resource:
      # 指定监控的资源为 CPU。
      name: cpu
      target:
        # 使用 Utilization 类型的目标，表示根据资源利用率来伸缩。
        type: Utilization
        # 设置平均 CPU 利用率的目标值为 60%，当超过这个值时会扩容，低于则可能缩容。
        averageUtilization: 60