Struct DeviceDerivedAttribute 

pub struct DeviceDerivedAttribute {
    pub expression: String,
    pub name: String,
}

DeviceDerivedAttribute defines a derived attribute computed via CEL.

Fields

expression: String

Expression is a CEL expression evaluated against each candidate device. The expression must evaluate to a primitive scalar (string, integer, boolean, or semver) or a list of these scalars ([]string, []int64, []bool, []semver) to act as a virtual grouping key. Any other return type is an error and causes CEL evaluation for the device to fail.

The expression’s input is an object named “device”, which carries the same properties as in a CELDeviceSelector.

When pod scheduling encounters CEL runtime errors (such as looking up an attribute that isn’t defined) for some devices, it will abort allocation and fail scheduling for the Pod. Surfacing evaluation errors immediately prevents silent topology matching failures that are extremely hard to detect. A robust expression should, for example, check for the existence of attributes before referencing them to avoid runtime evaluation errors.

The expression gets evaluated after a device has passed the other selector expressions for the request in which this expression is used. This allows writing expressions that are tailored towards the specific devices being requested (for example, by assuming the device is from a certain vendor and skipping those checks).

The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps; the combined cost of all derived attributes in a claim is capped by a shared CEL cost budget.

name: String

Name is the identifier for this derived attribute, used in constraints.

It must be a DNS subdomain followed by a slash (“/”) followed by a C identifier (e.g. “example.com/numaNode” or “derived/numaNode”).

If the chosen name matches an existing physical attribute from a driver, the derived attribute’s expression will shadow the physical attribute, and its evaluated value will be used in constraints instead. When the goal is to define a derived attribute that is only used within the ResourceClaim and not meant to shadow an existing attribute, use a domain prefix that no DRA driver should be using (e.g. “derived/myAttribute”).

It is not valid to define a derived attribute that isn’t used in at least one constraint.

Trait Implementations

impl Clone for DeviceDerivedAttribute

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceDerivedAttribute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeepMerge for DeviceDerivedAttribute

fn merge_from(&mut self, other: Self)

Merge other into self.

impl Default for DeviceDerivedAttribute

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DeviceDerivedAttribute

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DeviceDerivedAttribute

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for DeviceDerivedAttribute

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DeviceDerivedAttribute