chalkcfg get¶
Prints the node's documents of a kind, or the one with the given name. Without a kind, lists the kinds the image declares, other than Secret and the withheld kinds, with their groups and the node's number of documents of each.
Without --output, get prints the documents' names, one per line. -o json and -o yaml print the document named, or else a list {"items": [...], "kind": "List"} of all documents of the kind. -o jsonpath=<expression> and -o go-template=<template> print the result for each document on a line of its own, in name order. Expressions follow kubectl's: {.spec.location}, {.spec.tags[*]} or {.spec.labels['zone-a']}; an expression without braces is one path. Numbers compare as numbers, as in {.spec.neighbors[?(@.asn==65001)].ip} or {{if eq .spec.port 179}}. A field or key the document lacks is an error in both, also with a template's index.
A kind the image declares but the node has no documents of gives an empty result: no names, an empty list, or no lines. get exits with 0 on success and with 2 for a usage error. It exits with 1 for a kind the image does not declare, for Secret and a withheld kind, for a name the node has no document of, for a kind in more than one group, for a jsonpath expression or template that fails to parse or run, and for an error reading the config.
Flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
--output, -o |
string | — | Output format: json, yaml, jsonpath=<expression> or go-template=<template>; the documents' names without it. |
Examples¶
# The kinds the image declares and how many documents the node has of each.
chalkcfg get
# The names of the node's volumes, then one of them as YAML.
chalkcfg get Volume
chalkcfg get Volume data -o yaml
# A field of every document of a kind, one line per document.
chalkcfg get Node -o jsonpath='{.spec.type}'
chalkcfg get Node -o go-template='{{range .spec.taints}}{{.key}} {{end}}'
See also¶
- chalkcfg: Print the config documents of the node chalkcfg runs on