apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  nodeSelector:                    # 指定节点选择器
    disktype: ssd                  # 要求节点有 disktype=ssd 标签
    zone: east                     # 要求节点有 zone=east 标签
  containers:
  - name: app
    image: nginx

┌─────────────────────────────────────────────────────────┐
│                    调度过程                              │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Pod: nodeSelector: {disktype: ssd, zone: east}        │
│                         │                               │
│                         v                               │
│  ┌─────────────┬─────────────┬─────────────┐           │
│  │   Node A    │   Node B    │   Node C    │           │
│  │ disktype=hdd│ disktype=ssd│ disktype=ssd│           │
│  │ zone=east   │ zone=west   │ zone=east   │           │
│  │      X      │      X      │     ✓       │           │
│  └─────────────┴─────────────┴─────────────┘           │
│                                       │                 │
│                                       v                 │
│                              Pod 调度到 Node C          │
└─────────────────────────────────────────────────────────┘

# 查看节点标签
kubectl get nodes --show-labels

# 给节点添加标签
kubectl label nodes node1 disktype=ssd
kubectl label nodes node1 zone=east

# 删除节点标签
kubectl label nodes node1 disktype-

# 修改标签值
kubectl label nodes node1 disktype=hdd --overwrite

# 内置标签
kubernetes.io/hostname: node1           # 主机名
topology.kubernetes.io/zone: zone-a     # 可用区
topology.kubernetes.io/region: us-east  # 区域
node.kubernetes.io/instance-type: t3.medium  # 实例类型

# 自定义标签示例
disktype: ssd                          # 磁盘类型
gpu: "true"                            # 是否有 GPU
environment: production                # 环境
workload: compute                      # 工作负载类型

# 所有条件都必须满足（AND 关系）
spec:
  nodeSelector:
    disktype: ssd
    zone: east
    gpu: "true"
# 节点必须同时具有这三个标签

1. 硬件要求
   - GPU 工作负载调度到 GPU 节点
   - 高性能计算调度到大内存节点

2. 环境隔离
   - 生产环境调度到专用节点
   - 测试环境调度到测试节点

3. 合规要求
   - 数据本地化（调度到特定区域）
   - 特定硬件要求

4. 成本优化
   - 使用 Spot 实例运行非关键工作负载

# 给节点添加标签
kubectl label nodes node1 disktype=ssd
kubectl label nodes node1 zone=east
kubectl label nodes node2 disktype=hdd
kubectl label nodes node2 zone=west

# 验证标签
kubectl get nodes --show-labels

# pod-nodeselector.yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx-ssd
spec:
  nodeSelector:
    disktype: ssd
  containers:
  - name: nginx
    image: nginx

# 部署并验证
kubectl apply -f pod-nodeselector.yaml
kubectl get pod nginx-ssd -o wide
# 应该被调度到 node1（disktype=ssd）

# pod-nodeselector-fail.yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx-gpu
spec:
  nodeSelector:
    gpu: "true"
    disktype: ssd
    zone: north  # 不存在这个标签
  containers:
  - name: nginx
    image: nginx

# 部署并观察
kubectl apply -f pod-nodeselector-fail.yaml
kubectl get pod nginx-gpu
# 状态应该是 Pending

# 查看调度失败原因
kubectl describe pod nginx-gpu | grep -A 5 Events

# deployment-nodeselector.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      nodeSelector:
        environment: production
      containers:
      - name: web
        image: nginx

1. 硬性约束
   - 必须匹配所有标签（AND 关系）
   - 不支持"偏好"或"软性"要求

2. 不支持复杂逻辑
   - 不支持 OR 条件
   - 不支持 NOT 条件
   - 不支持 in/notin 操作符

3. 缺乏灵活性
   - 无法表达"优先但不强制"
   - 无法指定权重

替代方案：
   - nodeAffinity：支持复杂逻辑和软性约束
   - podAffinity/podAntiAffinity：Pod 间亲和性

# 检查节点标签
kubectl get nodes --show-labels

# 检查 Pod 的 nodeSelector
kubectl get pod <pod-name> -o yaml | grep -A 5 nodeSelector

# 检查是否有匹配的节点
kubectl get nodes -l disktype=ssd,zone=east

# 标签键格式
prefix/name: value

# 示例
app.kubernetes.io/name: myapp
kubernetes.io/hostname: node1

# 规则：
# - 前缀可选，最多 253 字符
# - 名称最多 63 字符
# - 只能包含字母、数字、-、_、.
# - 值最多 63 字符