Você está vendo a documentação do Kubernetes versão: v1.28
Kubernetes v1.28 a documentação não é mais mantida ativamente. A versão que você está visualizando no momento é uma cópia estática. Para obter a documentação atualizada, consulte última versão.
Seletores de Campos
Os Seletores de Campos permitem que você selecione recursos do Kubernetes baseado no valor de um ou mais campos de um recurso. Seguem alguns exemplos de buscas utilizando seletores de campos:
metadata.name=my-service
metadata.namespace!=default
status.phase=Pending
O comando kubectl
, mostrado a seguir, seleciona todos os Pods nos quais o valor do campo status.phase
é Running
:
kubectl get pods --field-selector status.phase=Running
kubectl
sejam equivalentes: kubectl get pods
e kubectl get pods --field-selector ""
Campos suportados
Os campos de seleção suportados variam dependendo do tipo de recurso Kubernetes. Todos os tipos de recursos suportam os campos metadata.name
e metadata.namespace
. Utilizar campos não suportados produz um erro. Como por exemplo:
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"
Operadores suportados
Você pode utilizar os operadores =
, ==
e !=
com seletores de campos (=
e ==
significam a mesma coisa). Por exemplo, o comando kubectl
a seguir seleciona todos os Kubernetes Services que não estão no namespace default
:
kubectl get services --all-namespaces --field-selector metadata.namespace!=default
Seletores em cadeia
Assim como label e outros tipos de seletores, podem ser utilizados em cadeia através de uma lista separada por vírgula. O comando kubectl
a seguir seleciona todos os Pods nos quais status.phase
não é igual a Running
e spec.restartPolicy
é igual a Always
kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always
Múltiplos tipos de recursos
Você pode utilizar seletores de campos através de múltiplos tipos de recursos. Por exemplo, o comando kubectl
a seguir seleciona todos Statefulsets e Services que não estão presentes no namespace default
.
kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default