Skip to content

cel.md

Latest commit

 

History

History
63 lines (41 loc) · 2.49 KB

cel.md

File metadata and controls

63 lines (41 loc) · 2.49 KB

CEL Expressions

Audience: Framework developers contributing to the adapter codebase. For practical CEL patterns aimed at adapter authors, see Adapter Authoring Guide — Appendix A.

Used in precondition expressions, lifecycle delete conditions, and post-action when gates.

Variables

Extracted params are injected as top-level names — write clusterID, not params.clusterID.

  • resources.* — discovered resources by alias (e.g., resources.myCluster)
  • adapter.* — adapter metadata (executionStatus, resourcesSkipped, skipReason, errorReason, errorMessage, executionError, resourceErrors). See adapterMetadataToMap() in internal/executor/utils.go for current fields.

Custom Functions

  • now() — current time as RFC3339 string
  • toJson(val) — serialize any value to JSON string
  • dig(map, "dot.path") — safe nested map access, returns null if missing

String Extensions

ext.Strings() is registered — available on string values:

charAt, indexOf, lastIndexOf, lowerAscii, replace, split, substring, trim, upperAscii, join

List Extensions

ext.Lists() is registered — available on list values:

  • <list>.distinct() — remove duplicate elements
  • <list>.sort() — sort comparable elements (string, int, bool, …)
  • <list>.sortBy(e, keyExpr) — sort objects by a derived key expression
  • <list>.slice(start, end) — sub-list from start (inclusive) to end (exclusive)
  • <list>.flatten() — recursively collapse nested lists; flatten(depth) limits depth
  • lists.range(n) — generate [0, 1, …, n-1]

Examples

// Precondition: check cluster is ready
resources.managedCluster.status.conditions.exists(c, c.type == "Ready" && c.status == "True")

// Post-action gate: check execution status
adapter.?executionStatus.orValue("") == "success"

// Post-action gate: skip when resources were skipped
adapter.?resourcesSkipped.orValue(false)

// Deduplicate and sort a tag list
spec.tags.distinct().sort()

// Sort node pools by replica count, extract names
spec.node_pools.sortBy(p, p.replicas).map(p, p.name)

// Flatten condition type+status pairs into one list
status.conditions.map(c, [c.type, c.status]).flatten()

Reference

  • CEL evaluator: internal/criteria/cel_evaluator.go
  • Custom functions registered: internal/criteria/cel_evaluator.go:71 (ext.Strings(), ext.Lists())
  • CEL validation at config load: internal/configloader/validator.go