0
0

Kubernetes cordon与port-forward、apiserver API及ConfigMap

2026-11-01
Kubernetes cordon与port-forward、apiserver API及ConfigMap

一、kubectl cordon / uncordon

1. cordon:标记节点不可调度

把节点标记为不可调度,并打上 node.kubernetes.io/unschedulable:NoSchedule 污点。若 Pod 配置了污点容忍,仍可调度上去。

kubectl cordon worker233
kubectl get nodes
# worker233  Ready,SchedulingDisabled

kubectl describe nodes | grep Taints -A 2
# Taints: node.kubernetes.io/unschedulable:NoSchedule
# Unschedulable: true

kubectl drain 底层就会调用 kubectl cordon。

2. uncordon:取消不可调度

kubectl uncordon worker233
kubectl get nodes
# worker233  Ready

取消标记的同时会自动删除 node.kubernetes.io/unschedulable:NoSchedule 污点。

二、kubectl port-forward 端口转发

把本地端口转发到目标资源的指定端口,效果类似 po.spec.containers.ports.hostPort。

kubectl port-forward pods/deloy-xiuxian-8676cbd54f-8ql29 \
  --address=0.0.0.0 88:80
# Forwarding from 0.0.0.0:88 -> 80

三、集群外部访问 Pod 的方式

  1. hostNetwork(共享宿主机网络);
  2. hostPort(映射宿主机端口);
  3. svc 的 NodePort;
  4. svc 的 LoadBalancer;
  5. kubectl port-forward;
  6. 基于 kube-apiserver 反向代理(早期版本支持,1.23.17 用相同 URI 无法访问);
  7. Ingress。

四、apiserver 的 API 使用案例

1. 响应式创建 svc

kubectl expose deployment deloy-xiuxian \
  --port=90 --protocol=TCP --target-port=80 --name=demo-xiuxian-svc

kubectl get svc demo-xiuxian-svc
# ClusterIP  10.200.182.15  90/TCP

2. 授权匿名用户

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: demo-system-anonymous
subjects:
- kind: User
  name: system:anonymous
  apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: ClusterRole
  name: cluster-admin
  apiGroup: rbac.authorization.k8s.io

3. apiserver 的 API 地址

早期版本(1.5.2)支持 apiserver 代理 ClusterIP svc,1.23.17 不支持。代理 svc 的 URI 格式:

https://10.0.0.231:6443/api/v1/proxy/namespaces/<名称空间>/services/<svc名称>

其他资源可直接访问:

https://10.0.0.231:6443/api/v1/pods        # 所有名称空间的 Pod
https://10.0.0.231:6443/api/v1/namespaces  # 所有名称空间
https://10.0.0.231:6443/                    # 列出可用 URL

测试完记得删除匿名授权,避免对 api-server 和 etcd 造成压力;真要对 api-server 做查询,建议用 Go / Python 等语言调用客户端库。

五、ConfigMap 概述

ConfigMap(cm)是 K8s 的配置映射,用于定义配置信息并挂载到容器中。KEY=VALUE 形式类似 Redis 键值对,数据存储在 etcd。

为什么要用 cm:

  1. 实现配置中心:多个 Pod 可挂载同一个 cm,支持把单个或多个键值对挂载到容器指定路径;
  2. 解耦配置与程序:镜像只读,改配置无需重新打镜像,把配置做成 cm 挂载即可。

六、ConfigMap 创建

1. 响应式创建

基于键值对:

kubectl create cm my.cnf \
  --from-literal=port=3306 \
  --from-literal=socket=/tmp/mysql80.sock

kubectl describe cm my.cnf

基于文件:

kubectl create cm mysql.cnf --from-file=mysql80.cnf=./my.cnf
kubectl describe cm mysql.cnf

删除:

kubectl delete cm my.cnf mysql.cnf

2. 声明式创建

apiVersion: v1
kind: ConfigMap
metadata:
  name: db.conf
data:
  host: 10.0.0.250
  port: "3306"          # 数字要用双引号
  my.cnf: |             # "|" 表示原样输出(块标量)
    [mysql]
    datadir=/demo/data/mysql80
    basedir=/demo/softwares/mysql80
    port=3306
    socket=/tmp/mysql80.sock

    [client]
    socket=/tmp/mysql80.sock
kubectl apply -f 01-cm.yaml
kubectl describe cm db.conf

七、Pod 引用 ConfigMap

1. 环境变量注入

spec:
  containers:
  - name: c1
    image: registry.cn-hangzhou.aliyuncs.com/demo-k8s/apps:v2
    env:
    - name: DB_HOSTNAME
      valueFrom:
        configMapKeyRef:
          name: db.conf
          key: host
    - name: DEMO_DB_PORT
      valueFrom:
        configMapKeyRef:
          name: db.conf
          key: port
    - name: DEMO_mycnf
      valueFrom:
        configMapKeyRef:
          name: db.conf
          key: my.cnf

2. 存储卷引用

把整个 cm 挂成目录:

spec:
  volumes:
  - name: data
    configMap:
      name: db.conf
  containers:
  - name: c1
    image: registry.cn-hangzhou.aliyuncs.com/demo-k8s/apps:v2
    volumeMounts:
    - name: data
      mountPath: /demo-cm

只挂载指定 key,并自定义文件名:

spec:
  volumes:
  - name: data
    configMap:
      name: db.conf
      items:
      - key: my.cnf
        path: mysql80.cnf
      - key: host
        path: host.txt
  containers:
  - name: c1
    image: registry.cn-hangzhou.aliyuncs.com/demo-k8s/apps:v2
    volumeMounts:
    - name: data
      mountPath: /demo-cm

验证:

kubectl exec cm-volume-001-xxx -- ls -l /demo-cm
# host -> ..data/host、my.cnf -> ..data/my.cnf、port -> ..data/port

kubectl exec cm-volume-002-xxx -- ls -l /demo-cm
# host.txt、mysql80.cnf

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!