Skip to main content

!labels.values

The !labels.values YAML function returns the values of the current component's own metadata.labels as a []string, ordered by key — useful when a module or script wants a flat list of label values instead of the full map.

Usage​

The !labels.values function takes no parameters:

components:
  terraform:
    vpc:
      metadata:
        labels:
          Namespace: eg
          Environment: prod
          cost-center: platform
      vars:
        label_values: !labels.values

Arguments​

This function takes no arguments. It reads metadata.labels from the component it's used on.

How It Works​

!labels.values reads the component's metadata.labels map and returns its values as a []string, ordered by key for deterministic output (Go map iteration order is randomized, so sorting by key matters for reproducible plans). If metadata.labels is unset, !labels.values returns an empty list rather than an error.

Examples​

stack.yaml
components:
  terraform:
    vpc:
      metadata:
        labels:
          Namespace: eg
          Environment: prod
          cost-center: platform
      vars:
        # label_values will be ["prod", "eg", "platform"] (ordered by sorted key:
        # Environment, Namespace, cost-center)
        label_values: !labels.values

Related Functions​

  • !labels - Get the current component's own metadata.labels as a map
  • !labels.keys - Get the current component's metadata.labels keys
  • !tags - Get the current component's own metadata.tags as a list