website/content/zh-cn/docs/concepts/overview/working-with-objects/field-selectors.md

4.8 KiB
Raw Blame History

title content_type weight
字段选择器 concept 70

“字段选择器Field selectors”允许你根据一个或多个资源字段的值筛选 Kubernetes {{< glossary_tooltip text="对象" term_id="object" >}}。 下面是一些使用字段选择器查询的例子:

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

下面这个 kubectl 命令将筛选出 status.phase 字段值为 Running 的所有 Pod

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

{{< note >}}

字段选择器本质上是资源“过滤器Filters”。默认情况下字段选择器/过滤器是未被应用的, 这意味着指定类型的所有资源都会被筛选出来。 这使得 kubectl get podskubectl get pods --field-selector "" 这两个 kubectl 查询是等价的。

{{< /note >}}

支持的字段

不同的 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"

支持的操作符

你可在字段选择器中使用 ===!= === 的意义是相同的)操作符。 例如,下面这个 kubectl 命令将筛选所有不属于 default 命名空间的 Kubernetes 服务:

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

{{< note >}}

基于集合的操作符 innotinexists)不支持字段选择算符。 {{< /note >}}

链式选择器

标签和其他选择器一样, 字段选择器可以通过使用逗号分隔的列表组成一个选择链。 下面这个 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