D8 Kubernetes

标准（必讲，但只读到"能看懂、能查询、能跟部署"）。公司生产跑在 k3s 集群上，新人要会只读操作、看得懂部署状态。

教学目标（学完能做什么）

• 能说出 K8s 核心对象与作用：Pod / Deployment / Service / Ingress / Namespace / ConfigMap / Secret
• 会用 kubectl 查询集群与服务状态（只读）
• 能看懂一个 Deployment/Ingress 清单，说出它部署了什么
• 知道公司集群环境（prod k3s）与"只看不改"的红线

前置要求

• D5（Linux）、D7（Docker，理解容器）

本模块在业务中的位置

• 公司所有服务都跑在 prod k3s 集群（唯一生产）。新人日常：查日志、看 Pod 状态、跟进发版。本模块给你"看集群"的能力；写清单/改集群是 D22 与后续带教的事。

内容分段

1. 为什么需要 K8s

• Docker 解决"单机怎么跑容器"；生产要多台机器、自动调度、故障自愈、滚动更新 → K8s。
• 公司实践：k3s（K8s 的轻量发行版，适合公司规模）。集群信息见 CLAUDE.md（master + 两个 worker）。

2. 核心对象（记牢，这是看集群的字典）

3. kubectl 只读操作（本模块核心技能）

kuse prod                          # 切到生产集群（公司脚本，见 CLAUDE.md）
kubectl get nodes                  # 看节点
kubectl get pods -A                # 看所有命名空间下的 Pod
kubectl get deploy -A              # 看 Deployment
kubectl get svc -n <ns>            # 看 Service
kubectl get ingress -A             # 看 Ingress（域名/证书路由）
kubectl describe pod <name> -n <ns>  # 看 Pod 详情（事件！）
kubectl logs <pod> -n <ns>         # 看日志
kubectl top nodes                 # 看节点资源（只读监控）

• 新人红线：以上全是 get/describe/logs/top 只读命令；apply/patch/delete/restart 一律不允许（Class A，见 AGENTS.md）。

4. 读一个清单（会看就行）

# 一个 Deployment 简化示意（公司真实清单在 manifests/apps/）
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
  namespace: default
spec:
  replicas: 2            # 两个副本
  selector:
    matchLabels: { app: myapp }
  template:
    metadata:
      labels: { app: myapp }
    spec:
      containers:
        - name: myapp
          image: registry.akria.net/myapp:v1   # 公司镜像仓库
          ports: [{ containerPort: 8000 }]

• 关键词：replicas（副本数）、image（哪个镜像，公司都从 registry.akria.net 拉）、labels（怎么互相认）。

5. 一次发版在 K8s 里长什么样（配合 D6 的 CI/CD 图）

1. CI 推送新镜像 tag 到 registry。
2. 触发 Deployment 更新（kubectl set image 或清单更新，属 Class A）。
3. K8s 滚动更新：起新 Pod → 健康检查通过 → 摘旧 Pod。
4. 期间 kubectl get pods -w 能实时看到 ContainerCreating → Running。
5. Service/Ingress 不变，客户无感。

• 常见状态：CrashLoopBackOff（起不来，看日志）、ImagePullBackOff（镜像拉不到，看名字/仓库）、Pending（资源不足/调度不了）。
• 不要删 CrashLoopBackOff 的 Pod（AGENTS.md 安全规则）——查日志找原因，别粗暴删除。

6. 集群存储与监控（了解）

• 存储：Longhorn（默认 2 副本）、longhorn-single（1 副本）——K8s 的持久化卷。
• 监控：headlamp（monitor.akria.net）可看集群；节点资源 kubectl top。
• 备份：Velero（kubectl get backup.velero.io）。

讲解节奏建议（约 90 分钟）

常见误区汇总