102 lines
5.4 KiB
Markdown
102 lines
5.4 KiB
Markdown
---
|
||
title: Поддержка JSONPath
|
||
content_template: templates/concept
|
||
weight: 25
|
||
---
|
||
|
||
{{% capture overview %}}
|
||
Kubectl поддерживает шаблон JSONPath.
|
||
{{% /capture %}}
|
||
|
||
{{% capture body %}}
|
||
|
||
Шаблон JSONPath состоит из выражений JSONPath, заключенных в фигурные скобки {}.
|
||
Kubectl использует JSONPath-выражения для фильтрации по определенным полям в JSON-объекте и форматирования вывода.
|
||
В дополнение к оригинальному синтаксису шаблона JSONPath, допустимы следующие функции и синтаксис:
|
||
|
||
1. Внутри выражений JSONPath текстовые значения заключайте в двойные кавычки.
|
||
2. Используйте операторы `range`, `end`, конечные операторы для перебора списков.
|
||
3. Используйте отрицательные индексы срезов для перехода на предыдущий элемент в списке. Отрицательные индексы не "зацикливаются" в списке и работают пока истинно выражение `-index + listLength >= 0`.
|
||
|
||
{{< note >}}
|
||
|
||
- Оператор `$` необязателен, поскольку по умолчанию выражение всегда начинается с корневого объекта.
|
||
|
||
- Объект результата выводиться через функцию String().
|
||
|
||
{{< /note >}}
|
||
|
||
Все примеры ниже будут ориентироваться на следующий JSON-объект:
|
||
|
||
```json
|
||
{
|
||
"kind": "List",
|
||
"items":[
|
||
{
|
||
"kind":"None",
|
||
"metadata":{"name":"127.0.0.1"},
|
||
"status":{
|
||
"capacity":{"cpu":"4"},
|
||
"addresses":[{"type": "LegacyHostIP", "address":"127.0.0.1"}]
|
||
}
|
||
},
|
||
{
|
||
"kind":"None",
|
||
"metadata":{"name":"127.0.0.2"},
|
||
"status":{
|
||
"capacity":{"cpu":"8"},
|
||
"addresses":[
|
||
{"type": "LegacyHostIP", "address":"127.0.0.2"},
|
||
{"type": "another", "address":"127.0.0.3"}
|
||
]
|
||
}
|
||
}
|
||
],
|
||
"users":[
|
||
{
|
||
"name": "myself",
|
||
"user": {}
|
||
},
|
||
{
|
||
"name": "e2e",
|
||
"user": {"username": "admin", "password": "secret"}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
Функция | Описание | Пример | Результат
|
||
--------------------|---------------------------|-----------------------------------------------------------------|------------------
|
||
`text` | обычный текст | `kind is {.kind}` | `kind is List`
|
||
`@` | текущий объект | `{@}` | то же, что и ввод
|
||
`.` или `[]` | оператор выбора по ключу | `{.kind}`, `{['kind']}` или `{['name\.type']}` | `List`
|
||
`..` | рекурсивный спуск | `{..name}` | `127.0.0.1 127.0.0.2 myself e2e`
|
||
`*` | шаблон подстановки. Получение всех объектов | `{.items[*].metadata.name}` | `[127.0.0.1 127.0.0.2]`
|
||
`[start:end:step]` | оператор индексирования | `{.users[0].name}` | `myself`
|
||
`[,]` | оператор объединения | `{.items[*]['metadata.name', 'status.capacity']}` | `127.0.0.1 127.0.0.2 map[cpu:4] map[cpu:8]`
|
||
`?()` | фильтрация | `{.users[?(@.name=="e2e")].user.password}` | `secret`
|
||
`range`, `end` | перебор списка | `{range .items[*]}[{.metadata.name}, {.status.capacity}] {end}` | `[127.0.0.1, map[cpu:4]] [127.0.0.2, map[cpu:8]]`
|
||
`''` | интерпретируемая в кавычках строка | `{range .items[*]}{.metadata.name}{'\t'}{end}` | `127.0.0.1 127.0.0.2`
|
||
|
||
Примеры использования `kubectl` и JSONPath-выражений:
|
||
|
||
```shell
|
||
kubectl get pods -o json
|
||
kubectl get pods -o=jsonpath='{@}'
|
||
kubectl get pods -o=jsonpath='{.items[0]}'
|
||
kubectl get pods -o=jsonpath='{.items[0].metadata.name}'
|
||
kubectl get pods -o=jsonpath="{.items[*]['metadata.name', 'status.capacity']}"
|
||
kubectl get pods -o=jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.startTime}{"\n"}{end}'
|
||
```
|
||
|
||
{{< note >}}
|
||
В Windows нужно заключить в _двойные_ кавычки JSONPath-шаблон, который содержит пробелы (не в одинарные, как в примерах выше для bash). Таким образом, любые литералы в таких шаблонов нужно оборачивать в одинарные кавычки или экранированные двойные кавычки. Например:
|
||
|
||
```cmd
|
||
kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{'\t'}{.status.startTime}{'\n'}{end}"
|
||
kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status.startTime}{\"\n\"}{end}"
|
||
```
|
||
{{< /note >}}
|
||
|
||
{{% /capture %}}
|