list-setters

List setters on resource fields.

Overview #

Lists information about setters like setter name, values and count.

Refer to the create-setters function documentation for information about creating new setters or apply-setters function documentation for information about updating the field values parameterized by setters.

Usage #

list-setters function is expected to be executed imperatively like

$ kpt fn eval -i ghcr.io/kptdev/krm-functions-catalog/list-setters:v0.1

list-setters function performs the following steps:

  1. Searches for setter comments in input list of resources.
  2. Lists discovered setters and related information.

Examples #

Listing setters in a package #

Let’s start with the input resource in a package

# resources.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
spec:
  replicas: 4 # kpt-set: ${nginx-replicas}
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: "nginx:1.16.1" # kpt-set: nginx:${tag}
        ports:
        - protocol: TCP
          containerPort: 80

Invoke the function:

$ kpt fn eval --image ghcr.io/kptdev/krm-functions-catalog/list-setters:v0.1

Output looks like the following:

  Results:
    [INFO] Name: nginx-replicas, Value: 4, Type: int, Count: 1
    [INFO] Name: tag, Value: 1.16.1, Type: str, Count: 1
Last modified April 21, 2026: Sync all docs using new mech (#1235) (af50d24)