kubectl-tree

kubectl-tree 资源归属树

补充说明

kubectl-tree 是 kubectl 插件，用 ownerReferences 展开资源的归属关系，例如 Deployment → ReplicaSet → Pod、Service → EndpointSlice、PVC → PV。排障时能快速看清“这个 Pod 是谁创建的”。

核心原理是递归读取 metadata.ownerReferences，不依赖标签，因此比手动 grep 更准确。

语法

安装 Krew：

(
  set -x
  cd "$(mktemp -d)" &&
  OS="$(uname | tr '[:upper:]' '[:lower:]')" &&
  ARCH="$(uname -m | sed -e 's/x86_64/amd64/' -e 's/\(arm\)\(64\)\?.*/\1\2/' -e 's/aarch64$/arm64/')" &&
  curl -fsSLO "https://github.com/kubernetes-sigs/krew/releases/latest/download/krew-${OS}_${ARCH}.tar.gz" &&
  tar zxvf "krew-${OS}_${ARCH}.tar.gz" &&
  ./krew-"${OS}_${ARCH}" install krew
)
export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"

安装插件：

kubectl krew install tree

查看 Deployment 的归属树：

kubectl tree deploy demo -n demo

查看所有命名空间：

kubectl tree deploy demo -n demo -A

查看 Service：

kubectl tree svc demo -n demo

查看 CRD 资源：

kubectl tree rollouts demo -n demo

注意

• 只依赖 ownerReferences，没有 owner 的资源不会展开。
• 跨命名空间的 owner 引用在 Kubernetes 中通常不允许，树不会跨命名空间。
• 大规模命名空间下递归查询较慢，尽量指定资源名。
• CRD 的 ownerReferences 可能由 Operator 管理，树的结构取决于实现。
• 删除父资源时，ownerReferences 的 blockOwnerDeletion 和 finalizer 会影响子资源。
• 插件版本与 kubectl 版本不兼容时，命令可能报错。
• 不要用树替代事件和日志，它只展示归属关系。
• 生产集群只读权限即可使用，不需要写权限。

相关命令

• kubectl tree — 展示归属树
• kubectl get pod -o yaml — 查看 ownerReferences
• kubectl describe — 查看事件
• kubectl krew — 插件管理
• kubectl get all — 查看常用资源

参考链接

• https://github.com/ahmetb/kubectl-tree
• https://krew.sigs.k8s.io/
• https://kubernetes.io/docs/concepts/overview/working-with-objects/owners-dependents/