Skip to content

Seanergys rfc31 resource attribute comparison - #563

Open
adfaure wants to merge 2 commits into
flux-framework:masterfrom
adfaure:seanergys-rfc31-resource-attribute-comparison
Open

adfaure wants to merge 2 commits into
flux-framework:masterfrom
adfaure:seanergys-rfc31-resource-attribute-comparison

Conversation

@adfaure

@adfaure adfaure commented Oct 21, 2026 •

Copy link
Copy Markdown

Add numeric comparison constraints on property values

Problem: a job cannot select nodes by a numeric characteristic representing a non-consumable fixed property, e.g. :

  • "rated under 400 Thermal design power" (energy-constrained jobs) .
  • "network link of at least N Gb/s" (data-intensive jobs).
  • "CPU generation should be above 1.5".
  • "CPU min frequency".
  • ...

Workarounds fall short:

  • Tags (bw_3000): the admin must define every threshold in advance.
  • Pools: a pool is consumed. Two jobs asking for "bw ≥ 3000" on a 3350 node: the first books the pool, the second is refused although a core is free.

OAR (-p "memnode > 64000") supports this.

Proposal

Fluxion already stores property values; this adds a constraint that reads them:

{ "lt": [ { "property": "thermal_design_power", "value": 400 } ] }

Operators lt, le, gt, ge. A missing or non-numeric value does not match. Composes with and/or/not. An exact value is and of ge and le; eq/ne could be added if preferred.

The syntax is a placeholder. A shorter form, { "thermal_design_power": [ "<400" ] }, would follow the RFC 43 convention; the form above keeps the operator set closed.

Open question: property values

The operators read a property's value, but no RFC defines one. Fluxion stores properties as name → string: JGF (RFC 40) carries "properties": {"thermal_design_power": "350"}, and flux ion-resource set-property sets them. RFC 40 requires the properties key but leaves its form undefined, and R (RFC 20) has no place for a value (Fluxion writes thermal_design_power=350 as a name).
We kept this PR to RFC 31. Should the value form be specified, e.g. in RFC 40, and should that happen here or in a follow-up?

Limitations

  • Evaluated on node and storage_node only, like other constraints.

Problem: RFC 31 can only test whether an execution target has a
property, not compare the property's value. A job cannot select
targets by a numeric characteristic with its own threshold, such as
nodes rated under 400 W.

Add four operators, lt, le, gt and ge, taking an object that names the
property and the value to compare against:

  { "lt": [ { "property": "power", "value": 400 } ] }

Several objects in one operator are conjunctive. A target without the
property, or whose value cannot be read as a number, does not match.

Assisted-by: Claude:opus-5.5
Problem: the review of RFC 31 asked to drop the reference to RFC 35
and to say how a property value is compared with a number.

Drop RFC 35 from Related Standards: nothing in the new text refers
to it. A target whose value cannot be read as a number does not match,
replacing "cannot be compared with value".

Add a word about preserving previous behavior when using tagged
properties.

Assisted-by: Claude:opus-5.5
@trws

trws commented Nov 4, 2026

Copy link
Copy Markdown
Member

I really like this idea. Will have to take some time to read over the proposal, but it certainly seems like it's worth doing for things that are non-consumable like versions or architectures or similar.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants