字段选择器
字段选择器(Field selectors)允许你基于一个或多个资源字段的值来选择 Kubernetes 对象。这里是一些字段选择器查询的示例:
metadata.name=my-servicemetadata.namespace!=defaultstatus.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.nodeNamespec.restartPolicyspec.schedulerNamespec.serviceAccountNamespec.hostNetworkstatus.phasestatus.podIPstatus.nominatedNodeName |
| Event | involvedObject.kindinvolvedObject.namespaceinvolvedObject.nameinvolvedObject.uidinvolvedObject.apiVersioninvolvedObject.resourceVersioninvolvedObject.fieldPathreasonreportingComponentsourcetype |
| Secret | type |
| Namespace | status.phase |
| ReplicaSet | status.replicas |
| ReplicationController | status.replicas |
| Job | status.successful |
| Node | spec.unschedulable |
| CertificateSigningRequest | spec.signerName |
自定义资源的字段
所有自定义资源类型都支持 metadata.name 和 metadata.namespace 字段。
此外,自定义资源定义(CustomResourceDefinition)的 spec.versions[*].selectableFields 字段声明了自定义资源中哪些其他字段可以在字段选择器中使用。有关如何将字段选择器与 CustomResourceDefinitions 一起使用的更多信息,请参见自定义资源的可选择字段。
支持的操作符
你可以将 =、== 和 != 操作符与字段选择器一起使用(= 和 == 含义相同)。例如,以下 kubectl 命令选择所有不在 default 命名空间中的 Kubernetes Service:
kubectl get services --all-namespaces --field-selector metadata.namespace!=default
链式选择器
与标签和其他选择器一样,字段选择器可以链接起来,构成一个逗号分隔的列表。此 kubectl 命令选择所有 status.phase 不等于 Running 且 spec.restartPolicy 字段等于 Always 的 Pod:
kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always
多种资源类型
你可以在多种资源类型上使用字段选择器。此 kubectl 命令选择所有不在 default 命名空间中的 StatefulSet 和 Service:
kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default
最后修改于 2024 年 10 月 31 日太平洋标准时间 10:47 AM:移除稳定功能的特性门控信息,向字段选择器文档添加详细信息 (2b996e4434)