apiVersion: v1
kind: Pod
metadata:
  # 元数据部分
  name: my-pod
  namespace: default
  labels:
    app: my-app
    tier: frontend
  annotations:
    description: "This is a test pod"
spec:
  # 规格部分
  containers:
  - name: my-container
    image: nginx:latest
    # 容器相关配置...
  # 其他 Pod 级别配置...

# API版本声明
apiVersion: v1
# 资源类型声明
kind: Pod
# 元数据部分
metadata:
  # Pod名称（在命名空间中必须唯一）
  name: my-webapp
  # 命名空间（不指定则使用default）
  namespace: default
  # 标签（用于选择器识别）
  labels:
    app: web
    environment: production
    tier: frontend
  # 注解（存储非识别性元数据）
  annotations:
    owner: "dev-team"
    build-version: "1.2.3"
# Pod规格定义（核心配置）
spec:
  # 主容器列表（必须至少一个）
  containers:
  # 第一个容器定义
  - name: web-container           # 容器名称
    image: nginx:1.19             # 容器镜像
    imagePullPolicy: IfNotPresent # 镜像拉取策略
    # 端口配置
    ports:
    - name: http                  # 端口名称
      containerPort: 80           # 容器内监听端口
      protocol: TCP               # 协议类型
    
    # 资源限制
    resources:
      # 请求资源（调度依据）
      requests:
        cpu: "500m"               # 0.5个CPU核心
        memory: "512Mi"           # 512MB内存
      # 限制资源（运行上限）
      limits:
        cpu: "1"                 # 1个CPU核心
        memory: "1Gi"            # 1GB内存
    
    # 环境变量
    env:
    - name: ENV_MODE              # 变量名
      value: "production"         # 变量值
    - name: DB_HOST
      valueFrom:
        configMapKeyRef:          # 从ConfigMap获取
          name: app-config
          key: db.host
    
    # 存活探针
    livenessProbe:
      httpGet:                    # HTTP检查方式
        path: /healthz            # 检查路径
        port: 80                  # 检查端口
      initialDelaySeconds: 15     # 首次检查延迟(秒)
      periodSeconds: 20           # 检查间隔(秒)
      timeoutSeconds: 5           # 超时时间(秒)
      failureThreshold: 3         # 失败阈值
    
    # 就绪探针
    readinessProbe:
      tcpSocket:                  # TCP端口检查方式
        port: 80
      initialDelaySeconds: 5
      periodSeconds: 10
    
    # 存储卷挂载
    volumeMounts:
    - name: config-volume         # 引用spec.volumes中的名称
      mountPath: /etc/nginx/conf.d # 容器内挂载路径
      readOnly: true              # 是否只读
  
  # 初始化容器（在主容器前运行）
  initContainers:
  - name: init-config
    image: busybox:1.28
    command: ['sh', '-c', 'echo Initializing... && sleep 5']
  
  # Pod级别存储卷定义
  volumes:
  # ConfigMap类型卷
  - name: config-volume
    configMap:
      name: nginx-config          # ConfigMap名称
      items:                      # 键映射配置
      - key: nginx.conf
        path: nginx.conf
  
  # 临时空目录卷
  - name: log-volume
    emptyDir: {}
  
  # 重启策略
  restartPolicy: Always
  
  # 节点选择器
  nodeSelector:
    disktype: ssd                # 选择有disktype=ssd标签的节点
  
  # 亲和性配置
  affinity:
    # Pod反亲和性（避免同类型Pod在同一节点）
    podAntiAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
          - key: app
            operator: In
            values:
            - web
        topologyKey: kubernetes.io/hostname
  
  # 容忍配置
  tolerations:
  - key: "special"               # 污点键
    operator: "Exists"           # 匹配方式
    effect: "NoSchedule"         # 污点效果
    tolerationSeconds: 3600      # 容忍时间（秒）

apiVersion: v1
kind: Pod
metadata:
  name: standalone-pod
spec:
  containers:
  - name: nginx
    image: nginx:1.19

apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: my-replicaset
spec:
  replicas: 3  # 始终维护3个副本
  selector:    # 匹配Pod的标签
    matchLabels:
      app: nginx
  template:    # Pod模板
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.19

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.19
        ports:
        - containerPort: 80
  strategy:
    type: RollingUpdate  # 滚动更新策略
    rollingUpdate:
      maxSurge: 1       # 更新期间允许超出副本数的最大值
      maxUnavailable: 0  # 更新期间允许不可用的副本数