Kubernetes 入门完全指南 2026：核心概念 + kubectl 实战 + Helm 应用部署

1
kubectl apply -f pod.yaml          # 创建 Pod
2
kubectl get pod my-nginx           # 查看状态
3
kubectl describe pod my-nginx      # 详细信息（含事件）
4
kubectl logs my-nginx              # 查看日志
5
kubectl logs my-nginx -f           # 实时日志
6
kubectl exec -it my-nginx -- sh    # 进入容器
7
kubectl delete pod my-nginx        # 删除 Pod

1
kubectl apply -f deployment.yaml
2

3
# 查看 Deployment 状态
4
kubectl get deployment myapp
5
# NAME    READY   UP-TO-DATE   AVAILABLE   AGE
6
# myapp   3/3     3            3           10s
7

8
# 滚动更新（修改镜像版本）
9
kubectl set image deployment/myapp myapp=myrepo/myapp:v1.3.0
10

11
# 查看更新进度
12
kubectl rollout status deployment/myapp
13

14
# 回滚到上一版本
15
kubectl rollout undo deployment/myapp
16

17
# 回滚到指定版本
18
kubectl rollout history deployment/myapp        # 查看历史
19
kubectl rollout undo deployment/myapp --to-revision=2
20

21
# 手动扩缩容
22
kubectl scale deployment myapp --replicas=5

1
kubectl apply -f service.yaml
2

3
# 集群内访问服务（通过 DNS）
4
# http://myapp-svc.default.svc.cluster.local:80
5

6
# 临时端口转发到本地（开发调试）
7
kubectl port-forward svc/myapp-svc 8080:80
8
# 现在可以 curl http://localhost:8080
9

10
# 查看 Service 详情
11
kubectl get svc myapp-svc
12
kubectl describe svc myapp-svc

1
# 创建 Secret（不推荐把 Secret YAML 提交到 git！）
2
kubectl create secret generic myapp-secret \
3
  --from-literal=db-password="password123" \
4
  --from-literal=api-key="myapikey"
5

6
# 从文件创建
7
kubectl create secret generic tls-secret \
8
  --from-file=tls.crt=./cert.pem \
9
  --from-file=tls.key=./key.pem
10

11
# 在 Pod 中使用 ConfigMap
12
# 方式一：注入为环境变量
13
envFrom:
14
  - configMapRef:
15
      name: myapp-config
16

17
# 方式二：挂载为文件
18
volumes:
19
  - name: config-vol
20
    configMap:
21
      name: myapp-config
22
containers:
23
  - volumeMounts:
24
      - name: config-vol
25
        mountPath: /etc/myapp/config

1
kubectl apply -f hpa.yaml
2
kubectl get hpa myapp-hpa    # 查看 HPA 状态
3
# NAME        REFERENCE         TARGETS         MINPODS   MAXPODS   REPLICAS
4
# myapp-hpa   Deployment/myapp  30%/60%         2         10        2

1
# 安装 Helm
2
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
3
helm version
4

5
# 添加常用仓库
6
helm repo add stable          https://charts.helm.sh/stable
7
helm repo add ingress-nginx   https://kubernetes.github.io/ingress-nginx
8
helm repo add cert-manager    https://charts.jetstack.io
9
helm repo add bitnami         https://charts.bitnami.com/bitnami
10
helm repo update
11

12
# 搜索 Chart
13
helm search repo nginx
14

15
# 安装 Nginx Ingress Controller
16
helm install ingress-nginx ingress-nginx/ingress-nginx \
17
  --namespace ingress-nginx \
18
  --create-namespace \
19
  --set controller.replicaCount=2 \
20
  --set controller.service.type=LoadBalancer
21

22
# 安装 cert-manager（自动 HTTPS 证书）
23
helm install cert-manager cert-manager/cert-manager \
24
  --namespace cert-manager \
25
  --create-namespace \
26
  --set crds.enabled=true
27

28
# 安装 PostgreSQL
29
helm install my-postgres bitnami/postgresql \
30
  --set auth.postgresPassword=mysecretpassword \
31
  --set primary.persistence.size=10Gi
32

33
# 查看已安装的 Chart
34
helm list -A    # -A 显示所有 namespace
35

36
# 更新
37
helm upgrade ingress-nginx ingress-nginx/ingress-nginx
38

39
# 卸载
40
helm uninstall ingress-nginx -n ingress-nginx

1
# ── 查看资源 ──────────────────────────────────────────────────
2
kubectl get all                                    # 查看 default ns 所有资源
3
kubectl get all -n kube-system                     # 查看 kube-system ns
4
kubectl get pods -A                                # 所有 ns 的 Pod
5
kubectl get pods -w                                # 实时监听 Pod 状态变化
6
kubectl get pod myapp-xxx -o yaml                  # 以 YAML 格式输出完整定义
7
kubectl get events --sort-by='.lastTimestamp'      # 查看事件（按时间排序）
8

9
# ── 调试 ──────────────────────────────────────────────────────
10
kubectl describe pod myapp-xxx                     # 详细信息（含 Events）
11
kubectl logs myapp-xxx -c container-name           # 多容器 Pod 指定容器日志
12
kubectl logs -l app=myapp --tail=100               # 按标签查看所有 Pod 日志
13
kubectl exec -it myapp-xxx -- bash                 # 进入容器终端
14
kubectl top pod                                    # 查看 Pod CPU/内存用量
15
kubectl top node                                   # 查看节点资源用量
16

17
# ── 命名空间 ──────────────────────────────────────────────────
18
kubectl create namespace staging
19
kubectl config set-context --current --namespace=staging   # 切换默认 ns
20
kubectl get ns                                     # 查看所有 namespace
21

22
# ── 快速创建（不推荐生产使用）────────────────────────────────
23
kubectl create deployment nginx --image=nginx:alpine --replicas=3
24
kubectl expose deployment nginx --port=80 --type=NodePort
25

26
# ── 清理 ──────────────────────────────────────────────────────
27
kubectl delete -f deployment.yaml                  # 按文件删除
28
kubectl delete pod -l app=myapp                    # 按标签删除
29
kubectl delete all --all -n staging                # 删除 ns 下所有资源