Pod 配置详解

apiVersion: v1           # 核心 API 组的版本。
kind: Pod                # 告诉 K8s 这是一个 Pod，而不是 Deployment 或 Service。
metadata:
  name: min-nginx        # Pod 的名字（在同一个 Namespace 下，这个名字必须唯一）。
spec:
  containers:            # 这是一个列表（注意前面的短横线 -），意味着一个 Pod 里可以跑多个容器。
  - name: nginx-c        # 容器的名字
    image: nginx:alpine  # 使用的镜像，如果不写版本号，默认会去拉取 latest，在生产环境中强烈不建议这样做。

apiVersion: v1
kind: Pod
metadata:
  name: multi-container-pod
spec:
  # 定义共享存储卷，这是多容器协作的基础
  volumes:
  - name: shared-data
    emptyDir: {}

  containers:
  # 容器 1：主应用容器 (Main Container)
  - name: app-container
    image: nginx:alpine
    volumeMounts:
    - name: shared-data
      mountPath: /usr/share/nginx/html # 挂载到 web 目录

  # 容器 2：辅助容器 (Sidecar Container)
  # 职责：例如每隔 5 秒生成一次数据，供主容器使用
  - name: sidecar-container
    image: alpine
    volumeMounts:
    - name: shared-data
      mountPath: /data                # 挂载到同一个卷
    command: ["/bin/sh"]
    args: ["-c", "while true; do date > /data/index.html; sleep 5; done"]

# 创建 Pod
kubectl apply -f multi-container-pod.yaml


# 查看 Pod 状态，应该看到 READY 列显示 2/2，这表示 Pod 中的两个容器都已正常启动并运行。
kubectl get pod multi-container-pod


# 验证实时更新，隔几秒执行一次，将发现输出的时间在变
kubectl exec multi-container-pod -c app-container -- curl localhost:80

apiVersion: v1
kind: Pod
metadata:
  name: image-policy-demo
spec:
  containers:
  # 1. Always：无论本地是否有镜像，每次启动都必须拉取
  - name: always-policy
    image: nginx:latest
    imagePullPolicy: Always

  # 2. IfNotPresent：如果本地没有才拉取（SRE 生产环境最推荐，节省带宽）
  - name: if-not-present-policy
    image: nginx:1.21
    imagePullPolicy: IfNotPresent

  # 3. Never：只使用本地镜像，绝不尝试从远程仓库拉取
  - name: never-policy
    image: my-local-image:v1
    imagePullPolicy: Never

apiVersion: v1
kind: Pod
metadata:
  name: command-demo
spec:
  containers:
  - name: alpine-container
    image: alpine:3.18
    # 1. command：相当于 Docker 的 ENTRYPOINT
    # 如果不写，则运行镜像默认的程序
    command: ["/bin/sh", "-c"]
    
    # 2. args：相当于 Docker 的 CMD
    # 会作为参数传递给上面的 command
    args: 
    - |
      echo "Starting application..."
      sleep 10
      echo "Done."

# 技巧 A：解决容器启动即退出的问题
# 有时候我们需要进入一个没有守护进程的容器进行调试，可以用这个“死循环”命令防止容器退出：
command: ["/bin/sh", "-c", "while true; do sleep 3600; done"]


# 技巧 B：使用环境变量作为参数
# 可以通过 $(VAR_NAME) 语法在参数中引用容器内定义的环境变量：
env:
- name: APP_PORT
  value: "8080"
containers:
- name: app
  image: my-app:v1
  command: ["/app/server"]
  args: ["--port", "$(APP_PORT)"] # 动态注入变量

apiVersion: v1
kind: Pod
metadata:
  name: env-demo-pod
spec:
  containers:
  - name: app-container
    image: nginx:alpine
    env:
      # 1. 直接定义键值对 (Static Value)
      - name: APP_REGION
        value: "china-east"

      # 2. 从 ConfigMap 中读取某个 Key (ConfigMap Ref)
      - name: LOG_LEVEL
        valueFrom:
          configMapKeyRef:
            name: app-config   # ConfigMap 的名字
            key: log_level     # ConfigMap 里的 Key

      # 3. 从 Secret 中读取加密信息 (Secret Ref)
      - name: DB_PASSWORD
        valueFrom:
          secretKeyRef:
            name: db-secret    # Secret 的名字
            key: password      # Secret 里的 Key

      # 4. 读取 Pod 自身的元数据 (Downward API)
      # 这在分布式系统中非常有用，比如应用需要知道自己的 Pod IP
      - name: MY_POD_IP
        valueFrom:
          fieldRef:
            fieldPath: status.podIP
      - name: MY_NODE_NAME
        valueFrom:
          fieldRef:
            fieldPath: spec.nodeName

    # 5. 批量注入 (envFrom)
    # 如果 ConfigMap 里有 50 个配置，不用一个个写，直接全部注入
    envFrom:
    - configMapRef:
        name: global-env-config

apiVersion: v1
kind: Pod
metadata:
  name: resource-demo
spec:
  containers:
  - name: heavy-app
    image: nginx:alpine
    resources:
      # 1. Requests (需求量)：调度依据
      # 只有当 Node 的剩余资源大于这个值时，Pod 才能被调度上去
      requests:
        cpu: "250m"      # 250m = 0.25 核
        memory: "512Mi"  # Mi 代表兆字节 (1024进制)

      # 2. Limits (上限值)：运行限制
      # 限制容器在运行时能使用的资源最大值
      limits:
        cpu: "1000m"     # 1000m = 1 核
        memory: "1Gi"    # Gi 代表吉字节 (1024进制)

# 查看单个 Pod 的 Qos 等级
kubectl describe pod <pod-name>| grep QoS

# 查看所有 Namespace 中的 Pod Qos 等级
kubectl get pods -A -o custom-columns="NAMESPACE:.metadata.namespace,NAME:.metadata.name,QOS:.status.qosClass"

apiVersion: v1
kind: Pod
metadata:
  name: probe-demo
spec:
  containers:
  - name: business-app
    image: nginx:1.21
    
    # -------------------------------------------------------
    # 1. 启动探针 (Startup Probe)
    # 作用：保护启动慢的应用。在它成功之前，其他探针都会被禁用。
    # -------------------------------------------------------
    startupProbe:
      httpGet:
        path: /api/startup
        port: 8080
      failureThreshold: 30     # 允许失败30次
      periodSeconds: 10        # 每10秒检查一次，总共给应用300秒启动时间

    # -------------------------------------------------------
    # 2. 就绪探针 (Readiness Probe)
    # 作用：决定流量是否接入。失败时，Pod 会从 Service 的 Endpoint 中移除。
    # -------------------------------------------------------
    readinessProbe:
      httpGet:
        path: /ready
        port: 8080
      initialDelaySeconds: 5   # 启动探针成功后，等待5秒开始检查
      periodSeconds: 10        # 检查频率
      successThreshold: 1      # 成功1次就算就绪
      failureThreshold: 3      # 连续失败3次移除流量

    # -------------------------------------------------------
    # 3. 存活探针 (Liveness Probe)
    # 作用：决定容器是否重启。失败时，K8s 会直接杀掉容器并按重启策略重启。
    # -------------------------------------------------------
    livenessProbe:
      tcpSocket:               # 也可以检查端口是否通
        port: 8080
      initialDelaySeconds: 15
      periodSeconds: 20

      httpGet:
        path: /healthz
        port: 8080

      tcpSocket:
        port: 8080

  exec:
    command: ["cat", "/tmp/healthy"]

apiVersion: v1
kind: Pod
metadata:
  name: lifecycle-demo
spec:
  containers:
  - name: app-container
    image: nginx:1.21
    lifecycle:
      # 1. PostStart: 容器创建后立即执行
      postStart:
        exec:
          command: ["/bin/sh", "-c", "echo 'Container started' > /var/log/start.log"]

      # 2. PreStop: 容器终止前执行
      preStop:
        exec:
          # 场景：通知 Nginx 优雅退出，并等待 10 秒让存量请求处理完
          command: ["/bin/sh", "-c", "/usr/sbin/nginx -s quit; sleep 10"]