首页/云/Kubernetes 速查/常用 topologyKey 与节点标签
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条配置与存储54 条
调度与资源52 条
集群运维与排障54 条

常用 topologyKey 与节点标签

拓扑域由节点标签决定:hostname 是节点级、zone/region 是机房级;调度与存储卷拓扑都依赖这些标准标签。

Kubernetes 速查云更新于 2026-10-12

标签键

标签键含义
kubernetes.io/hostname节点名(节点级域)
topology.kubernetes.io/zone可用区
topology.kubernetes.io/region地域
node.kubernetes.io/instance-type实例规格

核对标签覆盖

核对标签覆盖
kubectl get nodes -L topology.kubernetes.io/zone -L kubernetes.io/hostname
# 任何一个节点缺该标签,都会影响拓扑类约束的判定

易错点

  • 自建集群忘记打 zone 标签:拓扑约束与卷亲和都会失准
  • 多云/混合集群标签体系不统一时,先统一命名再上拓扑策略

数据来源与参考

  • Kubernetes 官方文档 · 知名标签与拓扑域
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌