字段选择器

字段选择器(Field selectors)允许你基于一个或多个资源字段的值来选择 Kubernetes 对象。这里是一些字段选择器查询的示例:

  • metadata.name=my-service
  • metadata.namespace!=default
  • status.phase=Pending

kubectl 命令选择所有 status.phase 字段值为 Running 的 Pod:

kubectl get pods --field-selector status.phase=Running

支持的字段

支持的字段选择器因 Kubernetes 资源类型而异。所有资源类型都支持 metadata.namemetadata.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"

支持的字段列表

资源类型字段
Podspec.nodeName
spec.restartPolicy
spec.schedulerName
spec.serviceAccountName
spec.hostNetwork
status.phase
status.podIP
status.nominatedNodeName
EventinvolvedObject.kind
involvedObject.namespace
involvedObject.name
involvedObject.uid
involvedObject.apiVersion
involvedObject.resourceVersion
involvedObject.fieldPath
reason
reportingComponent
source
type
Secrettype
Namespacestatus.phase
ReplicaSetstatus.replicas
ReplicationControllerstatus.replicas
Jobstatus.successful
Nodespec.unschedulable
CertificateSigningRequestspec.signerName

自定义资源的字段

所有自定义资源类型都支持 metadata.namemetadata.namespace 字段。

此外,自定义资源定义(CustomResourceDefinition)spec.versions[*].selectableFields 字段声明了自定义资源中哪些其他字段可以在字段选择器中使用。有关如何将字段选择器与 CustomResourceDefinitions 一起使用的更多信息,请参见自定义资源的可选择字段

支持的操作符

你可以将 ===!= 操作符与字段选择器一起使用(=== 含义相同)。例如,以下 kubectl 命令选择所有不在 default 命名空间中的 Kubernetes Service:

kubectl get services  --all-namespaces --field-selector metadata.namespace!=default

链式选择器

标签和其他选择器一样,字段选择器可以链接起来,构成一个逗号分隔的列表。此 kubectl 命令选择所有 status.phase 不等于 Runningspec.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)