字段选择器
字段选择器允许您根据一个或多个资源字段的值来选择 Kubernetes 对象。以下是一些字段选择器查询的示例
metadata.name=my-service
metadata.namespace!=default
status.phase=Pending
此 kubectl
命令选择 status.phase
字段值为 Running
的所有 Pod
kubectl get pods --field-selector status.phase=Running
注意
字段选择器本质上是资源*过滤器*。默认情况下,不应用任何选择器/过滤器,这意味着将选择指定类型的所有资源。这使得kubectl
查询 kubectl get pods
和 kubectl get pods --field-selector ""
等效。支持的字段
支持的字段选择器因 Kubernetes 资源类型而异。所有资源类型都支持 metadata.name
和 metadata.namespace
字段。使用不支持的字段选择器会产生错误。例如
kubectl get ingress --field-selector foo.bar=baz
Error from server (BadRequest): Unable to find "ingresses" that match label selector "", field selector "foo.bar=baz": "foo.bar" is not a known field selector: only "metadata.name", "metadata.namespace"
支持的字段列表
种类 | 字段 |
---|---|
Pod | spec.nodeName spec.restartPolicy spec.schedulerName spec.serviceAccountName spec.hostNetwork status.phase status.podIP status.nominatedNodeName |
Event | involvedObject.kind involvedObject.namespace involvedObject.name involvedObject.uid involvedObject.apiVersion involvedObject.resourceVersion involvedObject.fieldPath reason reportingComponent source type |
Secret | type |
Namespace | status.phase |
副本集 | status.replicas |
复制控制器 | status.replicas |
Job | status.successful |
Node | spec.unschedulable |
CertificateSigningRequest | spec.signerName |
自定义资源字段
所有自定义资源类型都支持 `metadata.name` 和 `metadata.namespace` 字段。
此外,自定义资源定义 的 `spec.versions[*].selectableFields` 字段声明了自定义资源中哪些其他字段可以在字段选择器中使用。有关如何在 CustomResourceDefinitions 中使用字段选择器的更多信息,请参阅自定义资源的可选择字段。
支持的运算符
您可以将 `=`、`==` 和 `!=` 运算符与字段选择器一起使用(`=` 和 `==` 含义相同)。例如,此 `kubectl` 命令选择不在 `default` 命名空间中的所有 Kubernetes 服务
kubectl get services --all-namespaces --field-selector metadata.namespace!=default
注意
基于集合的运算符(`in`、`notin`、`exists`)不支持字段选择器。链式选择器
与标签和其他选择器一样,字段选择器可以作为逗号分隔的列表链接在一起。此 `kubectl` 命令选择 `status.phase` 不等于 `Running` 且 `spec.restartPolicy` 字段等于 `Always` 的所有 Pod
kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always
多种资源类型
您可以在多种资源类型中使用字段选择器。此 `kubectl` 命令选择所有不在 `default` 命名空间中的 Statefulset 和服务
kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default
上次修改时间:2024 年 10 月 31 日上午 10:47 PST:删除稳定功能的字段门控信息,向字段选择器文档添加详细信息 (2b996e4434)