跳到主要内容

Kubernetes 基础笔记

由旧稿重新整理版本。K8s 系列新笔记共 8 篇:本文是基础与速查;II_Kubernetes部署特性笔记 是部署相关对象(Deployment/StatefulSet/Ingress/PV/HPA/RBAC 等);III_K3s笔记 是K3s 实战;IV_Rancher笔记 是集群管理 UI;Harbor笔记 是镜像仓库;I_Jenkins基础笔记 是CI 引擎基础;II_Jenkins_CICD实战笔记 是全链路流水线;小企业运维生产方案总览 是架构师视角总览。旧稿目录已清理,当前以本文为准。


1. Kubernetes 是什么​

Kubernetes(K8s)是 Google 开源的容器编排平台,用于自动化部署、扩缩、运维容器化应用。

核心能力:

  • 自动调度:把容器调度到合适节点
  • 自我修复:挂了自动重启、跨节点迁移
  • 滚动升级:无停机发版
  • 弹性扩缩:流量高峰自动扩容
  • 配置管理:ConfigMap / Secret 与镜像解耦
  • 服务发现 / 负载均衡:内置 DNS + Service
  • 密钥与证书管理:secret + cert-manager

2. 整体架构​

┌───────────────────── 控制平面(Control Plane)─────────────────────┐
│ │
│ kube-apiserver ◀─── 所有交互的统一入口(REST API) │
│ │ │
│ ┌────┼────┬──────────────┬─────────────────┐ │
│ │ │ │ │ │ │
│ scheduler controller-manager cloud-controller-manager │
│ (调度) (副本/节点/端点控制器) (云厂商对接) │
│ │ │
│ etcd ◀─── 集群所有状态(KV 存储) │
└───────────────────────────────────────────────────────────────────┘
▲ ▲
│ 监听 │
┌───────────────────── 工作节点(Worker Node)──────────────────────┐
│ kubelet kube-proxy 容器运行时(containerd / CRI-O) │
│ (节点代理) (网络代理) ┌─────────────────────┐ │
│ │ Pod / Container │ │
│ └─────────────────────┘ │
└───────────────────────────────────────────────────────────────────┘

2.1 控制平面(Control Plane)​

组件作用
kube-apiserverAPI 网关,所有组件(kubectl、kubelet、controller、scheduler)通过它读写集群状态
etcd强一致 KV 存储,保存集群所有数据;etcd 挂了 = 集群脑裂
kube-scheduler监听新创建的 Pod,决定它跑在哪个节点(资源、亲和性、污点等)
kube-controller-manager内嵌多个控制器:Deployment、StatefulSet、Node、Service 等

2.2 工作节点(Worker Node)​

组件作用
kubelet节点代理,向 API Server 注册、接收 PodSpec、用 CRI 创建容器
kube-proxy维护节点上的 iptables / IPVS 规则,实现 Service 转发
容器运行时containerd / CRI-O / Docker(已 deprecated),实际跑容器

2.3 K8s 与 Docker 的关系​

  • K8s 最初是 Docker 生态的"上层编排",但 K8s v1.24+ 已不再直接支持 Docker(dockershim 移除)
  • 现代 K8s 通过 CRI(Container Runtime Interface) 接入 containerd / CRI-O
  • Docker 镜像格式 OCI 仍通用,Dockerfile 仍可继续写

3. 核心对象(Everything is an Object)​

对象作用
Pod最小调度单元,可包含 1~N 个紧密耦合的容器(共享网络/卷)
Deployment管理 Pod 的副本和滚动升级
Service为一组 Pod 提供稳定 IP + DNS 名
Namespace逻辑分区(default / kube-system / 自定义)
ConfigMap非密配置
Secret敏感配置(base64 编码,非加密)
Ingress7 层路由(HTTP/HTTPS)
PersistentVolume / Claim持久化存储
ServiceAccountPod 用的身份
RBAC(Role / ClusterRole / Binding)权限控制

详细对象在 II_Kubernetes部署特性笔记。


4. YAML 基础​

K8s 资源全部用 YAML 声明。所有字段可由 kubectl explain <resource>.<field> 查询。

# 最低限度:apiVersion / kind / metadata / spec
apiVersion: apps/v1 # 哪一组 API
kind: Deployment # 哪种对象
metadata:
name: myapp
namespace: default
labels:
app: myapp
spec:
replicas: 3
selector:
matchLabels:
app: myapp
template:
metadata:
labels:
app: myapp
spec:
containers:
- name: myapp
image: nginx:1.27
ports:
- containerPort: 80

字段速记:

  • apiVersion:见 kubectl api-versions
  • kind:见 kubectl api-resources
  • metadata.name:资源名(同一 namespace 内唯一)
  • metadata.labels:任意 kv 标签,用于选择器 / 监控
  • metadata.annotations:任意 kv 注解(接 ingress、cert 等)

5. kubectl 速查​

5.1 上下文配置​

# kubeconfig 位置
~/.kube/config # 默认

# 多集群切换
kubectl config get-contexts
kubectl config use-context my-cluster

# 当前上下文信息
kubectl config current-context

5.2 看资源​

kubectl get pods # 当前 ns
kubectl get pods -A # 所有 ns
kubectl get pods -n kube-system
kubectl get pods -o wide # 含节点 + IP
kubectl get pods -l app=nginx # 按 label 过滤
kubectl get pod mypod -o yaml # 看完整定义
kubectl get pod mypod -o jsonpath='{.status.podIP}'

kubectl get deploy,svc,ing -n demo # 多种一起看

5.3 查详情与日志​

kubectl describe pod mypod # 含事件
kubectl describe node mynode # 节点资源/状态
kubectl logs mypod # 当前容器日志
kubectl logs mypod -c mycontainer # 多容器 pod 指定容器
kubectl logs mypod --previous # 上一个实例(崩溃后)
kubectl logs -f mypod # 实时跟随
kubectl logs -l app=nginx --tail=100 # 按 label 看日志

kubectl exec -it mypod -- bash # 进 pod 的第一个容器
kubectl exec -it mypod -c mycontainer -- sh # 指定容器

5.4 创建 / 修改 / 删除​

kubectl apply -f deployment.yaml # 声明式(推荐)
kubectl apply -f ./dir/ # 整个目录
kubectl apply -f - <<EOF # 从 stdin
apiVersion: v1
kind: ConfigMap
metadata:
name: hello
data:
world: hi
EOF

kubectl create -f deployment.yaml # 命令式创建(已存在报错)
kubectl create deployment nginx --image=nginx # 命令式快捷创建

kubectl edit deploy myapp # 临时改(存不住)
kubectl patch deploy myapp -p '{"spec":{"replicas":5}}'

kubectl delete -f deployment.yaml
kubectl delete pod mypod
kubectl delete pod -l app=nginx # 按 label 删
kubectl delete ns myns # 删 namespace

5.5 扩缩与回滚​

kubectl scale deploy myapp --replicas=5
kubectl autoscale deploy myapp --min=2 --max=10 --cpu-percent=80 # HPA
kubectl rollout status deploy myapp
kubectl rollout history deploy myapp
kubectl rollout undo deploy myapp # 回滚到上一版
kubectl rollout undo deploy myapp --to-revision=2

kubectl set image deploy/myapp myapp=myapp:v2 # 强写 image

5.6 调试与排错​

kubectl get events --sort-by=.metadata.creationTimestamp -A # 集群事件
kubectl get pods -A -o wide
kubectl top nodes # 节点资源
kubectl top pods # pod 资源

# 临时进调试容器(需要集群启用 ephemeral containers)
kubectl debug mypod -it --image=busybox --target=mycontainer

# 把本地端口转给 Pod / Service
kubectl port-forward svc/myapp 8080:80 # localhost:8080 → service:80
kubectl port-forward pod/mypod 8080:80

5.7 其他​

kubectl explain deployment.spec.template
kubectl api-resources
kubectl api-versions
kubectl cluster-info
kubectl version

6. 资源对象命名与 selector 机制​

spec:
selector:
matchLabels:
app: nginx
  • Deployment 用 selector.matchLabels 选定自己的 Pod
  • Service 用 selector 选定要转发到的 Pod
  • 改 label 后 selector 不匹配 = 旧 Pod 不被管理(Deployment 会"丢失"副本)
# 看 Deployment 实际管理哪些 Pod
kubectl get deploy nginx -o jsonpath='{.spec.selector.matchLabels}{"\n"}'
# 然后
kubectl get pods -l app=nginx

7. K8s 部署形态对比​

形态适用上手难度
minikube本地学最低
kind本地学,K8s in Docker低
k3d本地/小型,K3s in Docker低
K3s边缘 / 小型企业生产低(见 III_K3s笔记)
kubeadm自建集群中
RKE / RKE2Rancher 出品中
EKS / AKS / GKE公有云托管中
OpenShift企业级发行版高(含 cert-operator 等)

小企业首选 K3s(见后续笔记)。


8. 入门练习:本地 k3d​

# 安装 k3d + kubectl
curl -s https://raw.githubusercontent.com/k3d-io/k3d/main/install.sh | bash
brew install kubectl

# 起一个 3 节点 k3d 集群
k3d cluster create mycluster --agents 2

# kubectl 已自动配置好
kubectl get nodes
# 跑个 nginx
kubectl create deploy nginx --image=nginx:1.27
kubectl expose deploy nginx --port=80
kubectl port-forward svc/nginx 8080:80
# 浏览器打开 localhost:8080

# 清理
k3d cluster delete mycluster

9. 常见坑点​

现象原因解决
kubectl 报 Unable to connect to the serverkubeconfig 错误 / apiserver 不通检查 kubectl config view、网络
Pod pending节点资源不够 / PVC 没绑 / 镜像拉不下kubectl describe pod 看 Events
Pod CrashLoopBackOff容器启动错kubectl logs mypod --previous
Service IP 不通selector 没匹配上 Pod检查 label 是否一致
Ingress 不生效没装 ingress-controller装 Nginx Ingress 或 K3s 默认带 Traefik
镜像拉不下来(ErrImagePull)imagePullSecrets 不对 / 私有仓库未授权kubectl create secret docker-registry + imagePullSecrets
apply 后状态没更新字段太多 diff 困难先 delete 再 create,或用 kubectl diff -f 预览

10. 一句话总结​

  • K8s = 「容器编排」,不是「容器」本身(容器是 containerd/Docker 的事)
  • 控制平面(apiserver + etcd + scheduler + controller)做决策;节点(kubelet + 容器运行时)执行
  • 一切皆对象(Pod/Deployment/Service/…),YAML 是第一公民
  • 调试核心命令:get / describe / logs / exec / events