github
/
k3s
mirror of https://github.com/k3s-io/k3s
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Clarify the documentation on label selectors.

pull/6/head
Alex Robinson 2015-03-04 14:29:01 -08:00
parent eea1e88cb0
commit fa3ba189f2
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/labels.md
View File

@ -36,7 +36,15 @@ dimensions, such as:
These are just examples; you are free to develop your own conventions.
Label selectors permit very simple filtering by label keys and values. Currently, label selectors only support these forms:
Label selectors permit very simple filtering by label keys and values. The API currently only supports equality label selectors that are ANDed together. For example, if you specify the selector below in a JSON config, you'll only select resources that have both the labels `environment=dev` and `tier=frontend`:
```
"selector": {
"environment": "dev",
"tier": "frontend"
}
```
We [are actively working](https://github.com/GoogleCloudPlatform/kubernetes/issues/341) to support more types of selectors in the API, such as:
```
key1
key1 = value11
@ -45,7 +53,7 @@ key1 in (value11, value12, ...)
key1 not in (value11, value12, ...)
```
LIST and WATCH operations may specify label selectors to filter the sets of objects returned using a query parameter: `?labels=key1%3Dvalue1,key2%3Dvalue2,...`.
LIST and WATCH operations may specify label selectors to filter the sets of objects returned using a query parameter: `?labels=key1%3Dvalue1,key2%3Dvalue2,...`.
The `service` and `replicationController` kinds of objects use selectors to match sets of pods that they operate on.