Struct DeviceRequest

pub struct DeviceRequest {
    pub exactly: Option<ExactDeviceRequest>,
    pub first_available: Option<Vec<DeviceSubRequest>>,
    pub name: String,
}

DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices. With FirstAvailable it is also possible to provide a prioritized list of requests.

Fields

exactly: Option<ExactDeviceRequest>

Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.

One of Exactly or FirstAvailable must be set.

first_available: Option<Vec<DeviceSubRequest>>

FirstAvailable contains subrequests, of which exactly one will be selected by the scheduler. It tries to satisfy them in the order in which they are listed here. So if there are two entries in the list, the scheduler will only check the second one if it determines that the first one can not be used.

DRA does not yet implement scoring, so the scheduler will select the first set of devices that satisfies all the requests in the claim. And if the requirements can be satisfied on more than one node, other scheduling features will determine which node is chosen. This means that the set of devices allocated to a claim might not be the optimal set available to the cluster. Scoring will be implemented later.

name: String

Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.

References using the name in the DeviceRequest will uniquely identify a request when the Exactly field is set. When the FirstAvailable field is set, a reference to the name of the DeviceRequest will match whatever subrequest is chosen by the scheduler.

Must be a DNS label.

Trait Implementations

impl Clone for DeviceRequest

fn clone(&self) -> DeviceRequest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceRequest

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

Formats the value using the given formatter.

impl DeepMerge for DeviceRequest

fn merge_from(&mut self, other: Self)

Merge other into self.

impl Default for DeviceRequest

fn default() -> DeviceRequest

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DeviceRequest

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DeviceRequest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DeviceRequest

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 DeviceRequest