Selectors

Selector Expressions

Selectors are passed as arguments to Jikkou as expression strings in the following form:

• <SELECTOR>: <KEY> <OPERATOR> VALUE
• <SELECTOR>: <KEY> <OPERATOR> (VALUE[, VALUES])

or (using default field selector):

• <KEY> <OPERATOR> VALUE
• <KEY> <OPERATOR> (VALUE[, VALUES])

Selectors

Field (default)

Jikkou packs with a built-in FieldSelector allowing to filter resource objects based on a field key.

For example, the expression below shows you how to select only resource having a label environement equals to either staging or production.

metadata.labels.environement IN (staging, production)

Note: In the above example, we have omitted the selector because field is the default selector.

Expression Operators

Five kinds of operators are supported:

• IN
• NOTIN
• EXISTS
• MATCHES
• DOESNOTMATCH

Matching Strategies

Jikkou allows you to use multiple selector expressions. To indicate how these expressions are to be combined, you can pass one of the following matching strategies:

• ALL: A resource is selected if it matches all selectors.
• ANY: A resource is selected if it matches one of the selectors.
• NONE: A resource is selected if it matches none of the selectors.

Example:

jikkou get kafkatopics \
--selector 'metadata.name MATCHES (^__.*)' \
--selector 'metadata.name IN (_schemas)' \
--selector-match ANY