Struct ResourceSlice

pub struct ResourceSlice {
    pub metadata: ObjectMeta,
    pub spec: ResourceSliceSpec,
}

ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver.

At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple <driver name>, <pool name>, <device name>.

Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others.

When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool.

For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available.

This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Fields

metadata: ObjectMeta

Standard object metadata

spec: ResourceSliceSpec

Contains the information published by the driver.

Changing the spec automatically increments the metadata.generation number.

Trait Implementations

impl Clone for ResourceSlice

fn clone(&self) -> ResourceSlice

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceSlice

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

Formats the value using the given formatter.

impl DeepMerge for ResourceSlice

fn merge_from(&mut self, other: Self)

Merge other into self.

impl Default for ResourceSlice

fn default() -> ResourceSlice

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResourceSlice

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ListableResource for ResourceSlice

const LIST_KIND: &'static str = "ResourceSliceList"

The kind of the list type of the resource.

impl Metadata for ResourceSlice

type Ty = ObjectMeta

The type of the metadata object.

fn metadata(&self) -> &<Self as Metadata>::Ty

Gets a reference to the metadata of this resource value.

fn metadata_mut(&mut self) -> &mut <Self as Metadata>::Ty

Gets a mutable reference to the metadata of this resource value.

impl PartialEq for ResourceSlice

fn eq(&self, other: &ResourceSlice) -> 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 Resource for ResourceSlice

const API_VERSION: &'static str = "resource.k8s.io/v1alpha3"

The API version of the resource. This is a composite of Resource::GROUP and Resource::VERSION (eg "apiextensions.k8s.io/v1beta1") or just the version for resources without a group (eg "v1").

const GROUP: &'static str = "resource.k8s.io"

The group of the resource, or the empty string if the resource doesn’t have a group.

const KIND: &'static str = "ResourceSlice"

The kind of the resource.

const VERSION: &'static str = "v1alpha3"

The version of the resource.

const URL_PATH_SEGMENT: &'static str = "resourceslices"

The URL path segment used to construct URLs related to this resource.

type Scope = ClusterResourceScope

Indicates whether the resource is namespace-scoped or cluster-scoped or a subresource.

impl Serialize for ResourceSlice

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 ResourceSlice