01 环境准备与 kubectl 速查
属于 K8s Code 教程 · 第一篇 下一篇：02 Pod 与容器生命周期
动手写 K8s 之前，先确认手里有把趁手的"瑞士军刀"：kubectl 能连上集群、你能解释清楚自己在连谁。这一篇的目标很朴素——跑完下面的命令，你对自己的集群状态了如指掌，并且掌握 kubectl 的"命令分类思维"（以后遇到不认识的资源，也能举一反三）。
1. 核对集群状态
本教程默认你用 minikube 单节点集群。三连检查：
# 1) 控制面可达
kubectl cluster-info
# 输出应包含 Kubernetes control plane is running at https://...
# 2) 节点 Ready
kubectl get nodes -o wide
# NAME STATUS ROLES VERSION
# minikube Ready control-plane v1.35.1
# 3) 控制面组件健康
kubectl get pods -n kube-system
# coredns / etcd / kube-apiserver / kube-controller-manager / kube-proxy / kube-scheduler 应全部 Running看到 6 个控制面组件都 Running，你的"容器操作系统"就绪了。这 6 个组件是 K8s 的大脑，之前 S7 理论篇讲过：API Server 是唯一入口，etcd 是账本，Scheduler 找机器，Controller Manager 是监工，kubelet 是驻场管家，kube-proxy 管流量。
2. kubeconfig：你在以谁的身份说话
kubectl 通过 ~/.kube/config 决定"连哪个集群、以什么身份"。看三件事：
kubectl config view # 查看完整配置
kubectl config get-contexts # 列出所有 context
kubectl config current-context # 当前用的是哪个context = cluster + user + namespace 的三元组。为什么要有 context？因为你可能同时维护开发/测试/生产三个集群，context 就是"快捷切换"：kubectl config use-context minikube。每个 context 里还能预设默认 namespace，省得每条命令都加 -n。
生产警示
kubectl config current-context 是排查"我到底在操作哪个集群"的第一命令。多集群环境下误操作生产集群是最高频事故，养成切换后立刻 get nodes 确认的习惯。
3. kubectl 命令分类思维
kubectl 命令多，但按"用途"分只有五类，记住这个框架就抓住了主干：
| 类 | 命令 | 一句话 |
|---|---|---|
| 查看 | get | 列表式看资源（-o wide 更多列，-o yaml 看完整定义） |
| 查看 | describe | 看单个资源的详细事件/状态（排障主力） |
| 查看 | logs / exec | 看日志 / 进容器执行命令 |
| 变更 | apply | 声明式应用（推荐，和 YAML 对齐） |
| 变更 | delete | 删除（-f 按文件，-l 按标签） |
| 变更 | scale / rollout | 扩缩容 / 发布管理 |
| 排障 | get events | 集群事件流（排障第一现场） |
| 元数据 | explain | 查某个字段的 schema（写 YAML 的字典） |
4. 高频命令速查
# ---- 查看 ----
kubectl get pods # 默认 namespace
kubectl get pods -n kube-system # 指定 namespace
kubectl get pods -A # 所有 namespace
kubectl get pods -o wide # 加节点 IP 信息
kubectl get pods -l app=nginx # 按标签过滤
kubectl get deploy,svc,cm,secret # 一次看多种资源
kubectl describe pod <name> # 详情 + 事件
kubectl logs <pod> # 日志
kubectl logs <pod> -c <container> # 多容器 Pod 指定容器
kubectl logs <pod> --previous # 上次崩溃的日志（排障神器）
kubectl exec -it <pod> -- sh # 进容器
# ---- 变更 ----
kubectl apply -f xxx.yaml # 声明式应用
kubectl delete -f xxx.yaml # 按文件删
kubectl delete pod <name> --force --grace-period=0 # 强删（慎用）
kubectl scale deploy/nginx --replicas=5 # 扩缩容
kubectl rollout status deploy/nginx # 等发布完成
kubectl rollout undo deploy/nginx # 回滚
# ---- 输出格式 ----
kubectl get pods -o jsonpath='{.items[*].metadata.name}'
kubectl get pods -o custom-columns=NAME:.metadata.name,IP:.status.podIP5. 写 YAML 的字典：kubectl explain
不背字段，用 explain 现场查：
kubectl explain pod.spec.containers
kubectl explain pod.spec.containers.resources
kubectl explain deployment.spec.strategyexplain 会显示字段类型、是否必填、默认值——这就是你手写 YAML 的"字典"。配合 kubectl create <resource> --dry-run=client -o yaml 可以先让 kubectl 生成骨架再改。
6. 快速自检
kubectl config current-context输出什么？为什么它很重要？- 为什么排障第一件事是
kubectl get events而不是kubectl get pods？ kubectl explain pod.spec.containers.ports显示 containerPort 是必填吗？
串起来
这一篇你建立了三个习惯：连之前先确认 context，看资源用 get，查细节用 describe/explain。下一篇进入第一个要亲手写的对象——Pod：它是 K8s 的最小调度单位，探针、生命周期、initContainer 全都围绕它展开。先把 kubectl get pods -A 跑通，下一篇的 YAML 才有落点。
下一章：02 Pod 与容器生命周期