From c1a816b57abf39862b748b4f4c8e057a547d4668 Mon Sep 17 00:00:00 2001
From: Yann Hamon <yann+github@mandragor.org>
Date: Thu, 27 Mar 2025 10:39:13 +0000
Subject: [PATCH] Adding new schemas
---
master-local/_definitions.json | 1442 ++++++++++++++--
master-local/all.json | 117 ++
...llocateddevicestatus-resource-v1beta2.json | 55 +
master-local/allocateddevicestatus.json | 2 +-
.../allocationresult-resource-v1beta2.json | 15 +
master-local/allocationresult.json | 2 +-
.../basicdevice-resource-v1alpha3.json | 6 +-
.../basicdevice-resource-v1beta1.json | 8 +-
master-local/basicdevice.json | 8 +-
.../celdeviceselector-resource-v1beta2.json | 17 +
master-local/counter-resource-v1beta2.json | 14 +
.../counterset-resource-v1alpha3.json | 4 +-
master-local/counterset-resource-v1beta2.json | 28 +
master-local/counterset.json | 4 +-
master-local/deleteoptions-meta-v1.json | 6 +
master-local/deleteoptions.json | 5 +
master-local/device-resource-v1beta2.json | 77 +
master-local/device.json | 62 +-
...ocationconfiguration-resource-v1beta2.json | 35 +
.../deviceallocationconfiguration.json | 2 +-
...viceallocationresult-resource-v1beta2.json | 29 +
master-local/deviceallocationresult.json | 4 +-
.../deviceattribute-resource-v1beta2.json | 36 +
.../devicecapacity-resource-v1beta2.json | 14 +
.../deviceclaim-resource-v1beta2.json | 40 +
master-local/deviceclaim.json | 6 +-
...ceclaimconfiguration-resource-v1beta2.json | 25 +
master-local/deviceclaimconfiguration.json | 2 +-
.../deviceclass-resource-v1beta2.json | 45 +
master-local/deviceclass.json | 4 +-
...ceclassconfiguration-resource-v1beta2.json | 11 +
master-local/deviceclassconfiguration.json | 2 +-
.../deviceclasslist-resource-v1beta2.json | 51 +
master-local/deviceclasslist.json | 4 +-
.../deviceclassspec-resource-v1beta2.json | 29 +
master-local/deviceclassspec.json | 4 +-
.../deviceconstraint-resource-v1beta2.json | 28 +
...ecounterconsumption-resource-v1alpha3.json | 18 +-
...cecounterconsumption-resource-v1beta1.json | 18 +-
...cecounterconsumption-resource-v1beta2.json | 28 +
master-local/devicecounterconsumption.json | 20 +-
.../devicerequest-resource-v1beta2.json | 32 +
master-local/devicerequest.json | 61 +-
...uestallocationresult-resource-v1beta2.json | 59 +
.../devicerequestallocationresult.json | 2 +-
.../deviceselector-resource-v1beta2.json | 11 +
master-local/deviceselector.json | 2 +-
.../devicesubrequest-resource-v1alpha3.json | 2 +-
.../devicesubrequest-resource-v1beta1.json | 2 +-
.../devicesubrequest-resource-v1beta2.json | 62 +
master-local/devicesubrequest.json | 8 +-
.../devicetaint-resource-v1beta2.json | 36 +
.../devicetoleration-resource-v1beta2.json | 43 +
.../exactdevicerequest-resource-v1beta2.json | 61 +
master-local/exactdevicerequest.json | 61 +
.../networkdevicedata-resource-v1beta2.json | 35 +
master-local/networkdevicedata.json | 2 +-
...edeviceconfiguration-resource-v1beta2.json | 22 +
.../resourceclaim-resource-v1beta2.json | 49 +
master-local/resourceclaim.json | 6 +-
...aimconsumerreference-resource-v1beta2.json | 40 +
.../resourceclaimlist-resource-v1beta2.json | 51 +
master-local/resourceclaimlist.json | 4 +-
.../resourceclaimspec-resource-v1beta2.json | 11 +
master-local/resourceclaimspec.json | 2 +-
.../resourceclaimstatus-resource-v1beta2.json | 43 +
master-local/resourceclaimstatus.json | 6 +-
...esourceclaimtemplate-resource-v1beta2.json | 45 +
master-local/resourceclaimtemplate.json | 4 +-
...rceclaimtemplatelist-resource-v1beta2.json | 51 +
master-local/resourceclaimtemplatelist.json | 4 +-
...rceclaimtemplatespec-resource-v1beta2.json | 18 +
master-local/resourceclaimtemplatespec.json | 2 +-
.../resourcepool-resource-v1beta2.json | 35 +
.../resourceslice-resource-v1beta2.json | 45 +
master-local/resourceslice.json | 4 +-
.../resourceslicelist-resource-v1beta2.json | 51 +
master-local/resourceslicelist.json | 4 +-
.../resourceslicespec-resource-v1beta2.json | 69 +
master-local/resourceslicespec.json | 8 +-
master-local/watchevent-meta-v1.json | 5 +
master-local/watchevent.json | 5 +
master-standalone-strict/_definitions.json | 1449 +++++++++++++++--
master-standalone-strict/all.json | 117 ++
...llocateddevicestatus-resource-v1beta2.json | 136 ++
.../allocateddevicestatus.json | 2 +-
.../allocationresult-resource-v1beta2.json | 298 ++++
.../basicdevice-resource-v1alpha3.json | 18 +-
.../basicdevice-resource-v1beta1.json | 18 +-
master-standalone-strict/basicdevice.json | 18 +-
.../celdeviceselector-resource-v1beta2.json | 18 +
.../counter-resource-v1beta2.json | 27 +
.../counterset-resource-v1alpha3.json | 4 +-
.../counterset-resource-v1beta2.json | 55 +
master-standalone-strict/counterset.json | 2 +-
.../deleteoptions-meta-v1.json | 6 +
master-standalone-strict/deleteoptions.json | 5 +
.../device-resource-v1alpha3.json | 18 +-
.../device-resource-v1beta1.json | 18 +-
.../device-resource-v1beta2.json | 336 ++++
master-standalone-strict/device.json | 548 +++----
...ocationconfiguration-resource-v1beta2.json | 54 +
...viceallocationresult-resource-v1beta2.json | 170 ++
.../deviceattribute-resource-v1beta2.json | 37 +
.../devicecapacity-resource-v1beta2.json | 27 +
.../deviceclaim-resource-v1alpha3.json | 2 +-
.../deviceclaim-resource-v1beta1.json | 2 +-
.../deviceclaim-resource-v1beta2.json | 388 +++++
master-standalone-strict/deviceclaim.json | 250 +--
...ceclaimconfiguration-resource-v1beta2.json | 44 +
.../deviceclass-resource-v1beta2.json | 376 +++++
master-standalone-strict/deviceclass.json | 2 +-
...ceclassconfiguration-resource-v1beta2.json | 30 +
.../deviceclasslist-resource-v1beta2.json | 459 ++++++
master-standalone-strict/deviceclasslist.json | 4 +-
.../deviceclassspec-resource-v1beta2.json | 83 +
.../deviceconstraint-resource-v1beta2.json | 29 +
...ecounterconsumption-resource-v1alpha3.json | 18 +-
...cecounterconsumption-resource-v1beta1.json | 18 +-
...cecounterconsumption-resource-v1beta2.json | 55 +
.../devicecounterconsumption.json | 18 +-
.../devicerequest-resource-v1alpha3.json | 2 +-
.../devicerequest-resource-v1beta1.json | 2 +-
.../devicerequest-resource-v1beta2.json | 280 ++++
master-standalone-strict/devicerequest.json | 250 +--
...uestallocationresult-resource-v1beta2.json | 103 ++
.../deviceselector-resource-v1beta2.json | 25 +
.../devicesubrequest-resource-v1alpha3.json | 2 +-
.../devicesubrequest-resource-v1beta1.json | 2 +-
.../devicesubrequest-resource-v1beta2.json | 130 ++
.../devicesubrequest.json | 4 +-
.../devicetaint-resource-v1beta2.json | 41 +
.../devicetoleration-resource-v1beta2.json | 44 +
.../eviction-policy-v1.json | 6 +
master-standalone-strict/eviction.json | 5 +
.../exactdevicerequest-resource-v1beta2.json | 129 ++
.../exactdevicerequest.json | 129 ++
.../networkdevicedata-resource-v1beta2.json | 36 +
.../networkdevicedata.json | 2 +-
...edeviceconfiguration-resource-v1beta2.json | 26 +
.../resourceclaim-resource-v1alpha3.json | 2 +-
.../resourceclaim-resource-v1beta1.json | 2 +-
.../resourceclaim-resource-v1beta2.json | 1190 ++++++++++++++
master-standalone-strict/resourceclaim.json | 254 +--
...aimconsumerreference-resource-v1beta2.json | 41 +
.../resourceclaimlist-resource-v1alpha3.json | 2 +-
.../resourceclaimlist-resource-v1beta1.json | 2 +-
.../resourceclaimlist-resource-v1beta2.json | 1273 +++++++++++++++
.../resourceclaimlist.json | 256 +--
.../resourceclaimspec-resource-v1alpha3.json | 2 +-
.../resourceclaimspec-resource-v1beta1.json | 2 +-
.../resourceclaimspec-resource-v1beta2.json | 398 +++++
.../resourceclaimspec.json | 250 +--
.../resourceclaimstatus-resource-v1beta2.json | 497 ++++++
.../resourceclaimstatus.json | 2 +-
...sourceclaimtemplate-resource-v1alpha3.json | 2 +-
...esourceclaimtemplate-resource-v1beta1.json | 2 +-
...esourceclaimtemplate-resource-v1beta2.json | 954 +++++++++++
.../resourceclaimtemplate.json | 252 +--
...ceclaimtemplatelist-resource-v1alpha3.json | 2 +-
...rceclaimtemplatelist-resource-v1beta1.json | 2 +-
...rceclaimtemplatelist-resource-v1beta2.json | 1037 ++++++++++++
.../resourceclaimtemplatelist.json | 254 +--
...ceclaimtemplatespec-resource-v1alpha3.json | 2 +-
...rceclaimtemplatespec-resource-v1beta1.json | 2 +-
...rceclaimtemplatespec-resource-v1beta2.json | 664 ++++++++
.../resourceclaimtemplatespec.json | 250 +--
.../resourcepool-resource-v1beta2.json | 36 +
.../resourceslice-resource-v1alpha3.json | 22 +-
.../resourceslice-resource-v1beta1.json | 18 +-
.../resourceslice-resource-v1beta2.json | 876 ++++++++++
master-standalone-strict/resourceslice.json | 552 +++----
.../resourceslicelist-resource-v1alpha3.json | 22 +-
.../resourceslicelist-resource-v1beta1.json | 18 +-
.../resourceslicelist-resource-v1beta2.json | 959 +++++++++++
.../resourceslicelist.json | 554 ++++---
.../resourceslicespec-resource-v1alpha3.json | 22 +-
.../resourceslicespec-resource-v1beta1.json | 18 +-
.../resourceslicespec-resource-v1beta2.json | 589 +++++++
.../resourceslicespec.json | 550 +++----
.../watchevent-meta-v1.json | 5 +
master-standalone-strict/watchevent.json | 5 +
master-standalone/_definitions.json | 1442 ++++++++++++++--
master-standalone/all.json | 117 ++
...llocateddevicestatus-resource-v1beta2.json | 133 ++
master-standalone/allocateddevicestatus.json | 2 +-
.../allocationresult-resource-v1beta2.json | 288 ++++
.../basicdevice-resource-v1alpha3.json | 18 +-
.../basicdevice-resource-v1beta1.json | 18 +-
master-standalone/basicdevice.json | 18 +-
.../celdeviceselector-resource-v1beta2.json | 17 +
.../counter-resource-v1beta2.json | 26 +
.../counterset-resource-v1alpha3.json | 4 +-
.../counterset-resource-v1beta2.json | 53 +
master-standalone/counterset.json | 2 +-
master-standalone/deleteoptions-meta-v1.json | 6 +
master-standalone/deleteoptions.json | 5 +
.../device-resource-v1alpha3.json | 18 +-
.../device-resource-v1beta1.json | 18 +-
.../device-resource-v1beta2.json | 326 ++++
master-standalone/device.json | 539 +++---
...ocationconfiguration-resource-v1beta2.json | 52 +
...viceallocationresult-resource-v1beta2.json | 165 ++
.../deviceattribute-resource-v1beta2.json | 36 +
.../devicecapacity-resource-v1beta2.json | 26 +
.../deviceclaim-resource-v1alpha3.json | 2 +-
.../deviceclaim-resource-v1beta1.json | 2 +-
.../deviceclaim-resource-v1beta2.json | 375 +++++
master-standalone/deviceclaim.json | 241 +--
...ceclaimconfiguration-resource-v1beta2.json | 42 +
.../deviceclass-resource-v1beta2.json | 367 +++++
master-standalone/deviceclass.json | 2 +-
...ceclassconfiguration-resource-v1beta2.json | 28 +
.../deviceclasslist-resource-v1beta2.json | 448 +++++
master-standalone/deviceclasslist.json | 4 +-
.../deviceclassspec-resource-v1beta2.json | 78 +
.../deviceconstraint-resource-v1beta2.json | 28 +
...ecounterconsumption-resource-v1alpha3.json | 18 +-
...cecounterconsumption-resource-v1beta1.json | 18 +-
...cecounterconsumption-resource-v1beta2.json | 53 +
.../devicecounterconsumption.json | 18 +-
.../devicerequest-resource-v1alpha3.json | 2 +-
.../devicerequest-resource-v1beta1.json | 2 +-
.../devicerequest-resource-v1beta2.json | 271 +++
master-standalone/devicerequest.json | 241 +--
...uestallocationresult-resource-v1beta2.json | 101 ++
.../deviceselector-resource-v1beta2.json | 23 +
.../devicesubrequest-resource-v1alpha3.json | 2 +-
.../devicesubrequest-resource-v1beta1.json | 2 +-
.../devicesubrequest-resource-v1beta2.json | 126 ++
master-standalone/devicesubrequest.json | 4 +-
.../devicetaint-resource-v1beta2.json | 40 +
.../devicetoleration-resource-v1beta2.json | 43 +
master-standalone/eviction-policy-v1.json | 6 +
master-standalone/eviction.json | 5 +
.../exactdevicerequest-resource-v1beta2.json | 125 ++
master-standalone/exactdevicerequest.json | 125 ++
.../networkdevicedata-resource-v1beta2.json | 35 +
master-standalone/networkdevicedata.json | 2 +-
...edeviceconfiguration-resource-v1beta2.json | 25 +
.../resourceclaim-resource-v1alpha3.json | 2 +-
.../resourceclaim-resource-v1beta1.json | 2 +-
.../resourceclaim-resource-v1beta2.json | 1157 +++++++++++++
master-standalone/resourceclaim.json | 245 +--
...aimconsumerreference-resource-v1beta2.json | 40 +
.../resourceclaimlist-resource-v1alpha3.json | 2 +-
.../resourceclaimlist-resource-v1beta1.json | 2 +-
.../resourceclaimlist-resource-v1beta2.json | 1238 ++++++++++++++
master-standalone/resourceclaimlist.json | 247 +--
.../resourceclaimspec-resource-v1alpha3.json | 2 +-
.../resourceclaimspec-resource-v1beta1.json | 2 +-
.../resourceclaimspec-resource-v1beta2.json | 384 +++++
master-standalone/resourceclaimspec.json | 241 +--
.../resourceclaimstatus-resource-v1beta2.json | 482 ++++++
master-standalone/resourceclaimstatus.json | 2 +-
...sourceclaimtemplate-resource-v1alpha3.json | 2 +-
...esourceclaimtemplate-resource-v1beta1.json | 2 +-
...esourceclaimtemplate-resource-v1beta2.json | 932 +++++++++++
master-standalone/resourceclaimtemplate.json | 243 +--
...ceclaimtemplatelist-resource-v1alpha3.json | 2 +-
...rceclaimtemplatelist-resource-v1beta1.json | 2 +-
...rceclaimtemplatelist-resource-v1beta2.json | 1013 ++++++++++++
.../resourceclaimtemplatelist.json | 245 +--
...ceclaimtemplatespec-resource-v1alpha3.json | 2 +-
...rceclaimtemplatespec-resource-v1beta1.json | 2 +-
...rceclaimtemplatespec-resource-v1beta2.json | 646 ++++++++
.../resourceclaimtemplatespec.json | 241 +--
.../resourcepool-resource-v1beta2.json | 35 +
.../resourceslice-resource-v1alpha3.json | 22 +-
.../resourceslice-resource-v1beta1.json | 18 +-
.../resourceslice-resource-v1beta2.json | 854 ++++++++++
master-standalone/resourceslice.json | 543 +++---
.../resourceslicelist-resource-v1alpha3.json | 22 +-
.../resourceslicelist-resource-v1beta1.json | 18 +-
.../resourceslicelist-resource-v1beta2.json | 935 +++++++++++
master-standalone/resourceslicelist.json | 545 +++----
.../resourceslicespec-resource-v1alpha3.json | 22 +-
.../resourceslicespec-resource-v1beta1.json | 18 +-
.../resourceslicespec-resource-v1beta2.json | 571 +++++++
master-standalone/resourceslicespec.json | 541 +++---
master-standalone/watchevent-meta-v1.json | 5 +
master-standalone/watchevent.json | 5 +
master/_definitions.json | 1442 ++++++++++++++--
master/all.json | 117 ++
...llocateddevicestatus-resource-v1beta2.json | 55 +
master/allocateddevicestatus.json | 2 +-
master/allocationresult-resource-v1beta2.json | 15 +
master/allocationresult.json | 2 +-
master/basicdevice-resource-v1alpha3.json | 6 +-
master/basicdevice-resource-v1beta1.json | 8 +-
master/basicdevice.json | 8 +-
.../celdeviceselector-resource-v1beta2.json | 17 +
master/counter-resource-v1beta2.json | 14 +
master/counterset-resource-v1alpha3.json | 4 +-
master/counterset-resource-v1beta2.json | 28 +
master/counterset.json | 4 +-
master/deleteoptions-meta-v1.json | 6 +
master/deleteoptions.json | 5 +
master/device-resource-v1beta2.json | 77 +
master/device.json | 62 +-
...ocationconfiguration-resource-v1beta2.json | 35 +
master/deviceallocationconfiguration.json | 2 +-
...viceallocationresult-resource-v1beta2.json | 29 +
master/deviceallocationresult.json | 4 +-
master/deviceattribute-resource-v1beta2.json | 36 +
master/devicecapacity-resource-v1beta2.json | 14 +
master/deviceclaim-resource-v1beta2.json | 40 +
master/deviceclaim.json | 6 +-
...ceclaimconfiguration-resource-v1beta2.json | 25 +
master/deviceclaimconfiguration.json | 2 +-
master/deviceclass-resource-v1beta2.json | 45 +
master/deviceclass.json | 4 +-
...ceclassconfiguration-resource-v1beta2.json | 11 +
master/deviceclassconfiguration.json | 2 +-
master/deviceclasslist-resource-v1beta2.json | 51 +
master/deviceclasslist.json | 4 +-
master/deviceclassspec-resource-v1beta2.json | 29 +
master/deviceclassspec.json | 4 +-
master/deviceconstraint-resource-v1beta2.json | 28 +
...ecounterconsumption-resource-v1alpha3.json | 18 +-
...cecounterconsumption-resource-v1beta1.json | 18 +-
...cecounterconsumption-resource-v1beta2.json | 28 +
master/devicecounterconsumption.json | 20 +-
master/devicerequest-resource-v1beta2.json | 32 +
master/devicerequest.json | 61 +-
...uestallocationresult-resource-v1beta2.json | 59 +
master/devicerequestallocationresult.json | 2 +-
master/deviceselector-resource-v1beta2.json | 11 +
master/deviceselector.json | 2 +-
.../devicesubrequest-resource-v1alpha3.json | 2 +-
master/devicesubrequest-resource-v1beta1.json | 2 +-
master/devicesubrequest-resource-v1beta2.json | 62 +
master/devicesubrequest.json | 8 +-
master/devicetaint-resource-v1beta2.json | 36 +
master/devicetoleration-resource-v1beta2.json | 43 +
.../exactdevicerequest-resource-v1beta2.json | 61 +
master/exactdevicerequest.json | 61 +
.../networkdevicedata-resource-v1beta2.json | 35 +
master/networkdevicedata.json | 2 +-
...edeviceconfiguration-resource-v1beta2.json | 22 +
master/resourceclaim-resource-v1beta2.json | 49 +
master/resourceclaim.json | 6 +-
...aimconsumerreference-resource-v1beta2.json | 40 +
.../resourceclaimlist-resource-v1beta2.json | 51 +
master/resourceclaimlist.json | 4 +-
.../resourceclaimspec-resource-v1beta2.json | 11 +
master/resourceclaimspec.json | 2 +-
.../resourceclaimstatus-resource-v1beta2.json | 43 +
master/resourceclaimstatus.json | 6 +-
...esourceclaimtemplate-resource-v1beta2.json | 45 +
master/resourceclaimtemplate.json | 4 +-
...rceclaimtemplatelist-resource-v1beta2.json | 51 +
master/resourceclaimtemplatelist.json | 4 +-
...rceclaimtemplatespec-resource-v1beta2.json | 18 +
master/resourceclaimtemplatespec.json | 2 +-
master/resourcepool-resource-v1beta2.json | 35 +
master/resourceslice-resource-v1beta2.json | 45 +
master/resourceslice.json | 4 +-
.../resourceslicelist-resource-v1beta2.json | 51 +
master/resourceslicelist.json | 4 +-
.../resourceslicespec-resource-v1beta2.json | 69 +
master/resourceslicespec.json | 8 +-
master/watchevent-meta-v1.json | 5 +
master/watchevent.json | 5 +
364 files changed, 37322 insertions(+), 5444 deletions(-)
create mode 100644 master-local/allocateddevicestatus-resource-v1beta2.json
create mode 100644 master-local/allocationresult-resource-v1beta2.json
create mode 100644 master-local/celdeviceselector-resource-v1beta2.json
create mode 100644 master-local/counter-resource-v1beta2.json
create mode 100644 master-local/counterset-resource-v1beta2.json
create mode 100644 master-local/device-resource-v1beta2.json
create mode 100644 master-local/deviceallocationconfiguration-resource-v1beta2.json
create mode 100644 master-local/deviceallocationresult-resource-v1beta2.json
create mode 100644 master-local/deviceattribute-resource-v1beta2.json
create mode 100644 master-local/devicecapacity-resource-v1beta2.json
create mode 100644 master-local/deviceclaim-resource-v1beta2.json
create mode 100644 master-local/deviceclaimconfiguration-resource-v1beta2.json
create mode 100644 master-local/deviceclass-resource-v1beta2.json
create mode 100644 master-local/deviceclassconfiguration-resource-v1beta2.json
create mode 100644 master-local/deviceclasslist-resource-v1beta2.json
create mode 100644 master-local/deviceclassspec-resource-v1beta2.json
create mode 100644 master-local/deviceconstraint-resource-v1beta2.json
create mode 100644 master-local/devicecounterconsumption-resource-v1beta2.json
create mode 100644 master-local/devicerequest-resource-v1beta2.json
create mode 100644 master-local/devicerequestallocationresult-resource-v1beta2.json
create mode 100644 master-local/deviceselector-resource-v1beta2.json
create mode 100644 master-local/devicesubrequest-resource-v1beta2.json
create mode 100644 master-local/devicetaint-resource-v1beta2.json
create mode 100644 master-local/devicetoleration-resource-v1beta2.json
create mode 100644 master-local/exactdevicerequest-resource-v1beta2.json
create mode 100644 master-local/exactdevicerequest.json
create mode 100644 master-local/networkdevicedata-resource-v1beta2.json
create mode 100644 master-local/opaquedeviceconfiguration-resource-v1beta2.json
create mode 100644 master-local/resourceclaim-resource-v1beta2.json
create mode 100644 master-local/resourceclaimconsumerreference-resource-v1beta2.json
create mode 100644 master-local/resourceclaimlist-resource-v1beta2.json
create mode 100644 master-local/resourceclaimspec-resource-v1beta2.json
create mode 100644 master-local/resourceclaimstatus-resource-v1beta2.json
create mode 100644 master-local/resourceclaimtemplate-resource-v1beta2.json
create mode 100644 master-local/resourceclaimtemplatelist-resource-v1beta2.json
create mode 100644 master-local/resourceclaimtemplatespec-resource-v1beta2.json
create mode 100644 master-local/resourcepool-resource-v1beta2.json
create mode 100644 master-local/resourceslice-resource-v1beta2.json
create mode 100644 master-local/resourceslicelist-resource-v1beta2.json
create mode 100644 master-local/resourceslicespec-resource-v1beta2.json
create mode 100644 master-standalone-strict/allocateddevicestatus-resource-v1beta2.json
create mode 100644 master-standalone-strict/allocationresult-resource-v1beta2.json
create mode 100644 master-standalone-strict/celdeviceselector-resource-v1beta2.json
create mode 100644 master-standalone-strict/counter-resource-v1beta2.json
create mode 100644 master-standalone-strict/counterset-resource-v1beta2.json
create mode 100644 master-standalone-strict/device-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceallocationconfiguration-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceallocationresult-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceattribute-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicecapacity-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclaim-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclaimconfiguration-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclass-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclassconfiguration-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclasslist-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceclassspec-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceconstraint-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicecounterconsumption-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicerequest-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicerequestallocationresult-resource-v1beta2.json
create mode 100644 master-standalone-strict/deviceselector-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicesubrequest-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicetaint-resource-v1beta2.json
create mode 100644 master-standalone-strict/devicetoleration-resource-v1beta2.json
create mode 100644 master-standalone-strict/exactdevicerequest-resource-v1beta2.json
create mode 100644 master-standalone-strict/exactdevicerequest.json
create mode 100644 master-standalone-strict/networkdevicedata-resource-v1beta2.json
create mode 100644 master-standalone-strict/opaquedeviceconfiguration-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaim-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimconsumerreference-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimlist-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimspec-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimstatus-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimtemplate-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimtemplatelist-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceclaimtemplatespec-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourcepool-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceslice-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceslicelist-resource-v1beta2.json
create mode 100644 master-standalone-strict/resourceslicespec-resource-v1beta2.json
create mode 100644 master-standalone/allocateddevicestatus-resource-v1beta2.json
create mode 100644 master-standalone/allocationresult-resource-v1beta2.json
create mode 100644 master-standalone/celdeviceselector-resource-v1beta2.json
create mode 100644 master-standalone/counter-resource-v1beta2.json
create mode 100644 master-standalone/counterset-resource-v1beta2.json
create mode 100644 master-standalone/device-resource-v1beta2.json
create mode 100644 master-standalone/deviceallocationconfiguration-resource-v1beta2.json
create mode 100644 master-standalone/deviceallocationresult-resource-v1beta2.json
create mode 100644 master-standalone/deviceattribute-resource-v1beta2.json
create mode 100644 master-standalone/devicecapacity-resource-v1beta2.json
create mode 100644 master-standalone/deviceclaim-resource-v1beta2.json
create mode 100644 master-standalone/deviceclaimconfiguration-resource-v1beta2.json
create mode 100644 master-standalone/deviceclass-resource-v1beta2.json
create mode 100644 master-standalone/deviceclassconfiguration-resource-v1beta2.json
create mode 100644 master-standalone/deviceclasslist-resource-v1beta2.json
create mode 100644 master-standalone/deviceclassspec-resource-v1beta2.json
create mode 100644 master-standalone/deviceconstraint-resource-v1beta2.json
create mode 100644 master-standalone/devicecounterconsumption-resource-v1beta2.json
create mode 100644 master-standalone/devicerequest-resource-v1beta2.json
create mode 100644 master-standalone/devicerequestallocationresult-resource-v1beta2.json
create mode 100644 master-standalone/deviceselector-resource-v1beta2.json
create mode 100644 master-standalone/devicesubrequest-resource-v1beta2.json
create mode 100644 master-standalone/devicetaint-resource-v1beta2.json
create mode 100644 master-standalone/devicetoleration-resource-v1beta2.json
create mode 100644 master-standalone/exactdevicerequest-resource-v1beta2.json
create mode 100644 master-standalone/exactdevicerequest.json
create mode 100644 master-standalone/networkdevicedata-resource-v1beta2.json
create mode 100644 master-standalone/opaquedeviceconfiguration-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaim-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimconsumerreference-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimlist-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimspec-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimstatus-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimtemplate-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimtemplatelist-resource-v1beta2.json
create mode 100644 master-standalone/resourceclaimtemplatespec-resource-v1beta2.json
create mode 100644 master-standalone/resourcepool-resource-v1beta2.json
create mode 100644 master-standalone/resourceslice-resource-v1beta2.json
create mode 100644 master-standalone/resourceslicelist-resource-v1beta2.json
create mode 100644 master-standalone/resourceslicespec-resource-v1beta2.json
create mode 100644 master/allocateddevicestatus-resource-v1beta2.json
create mode 100644 master/allocationresult-resource-v1beta2.json
create mode 100644 master/celdeviceselector-resource-v1beta2.json
create mode 100644 master/counter-resource-v1beta2.json
create mode 100644 master/counterset-resource-v1beta2.json
create mode 100644 master/device-resource-v1beta2.json
create mode 100644 master/deviceallocationconfiguration-resource-v1beta2.json
create mode 100644 master/deviceallocationresult-resource-v1beta2.json
create mode 100644 master/deviceattribute-resource-v1beta2.json
create mode 100644 master/devicecapacity-resource-v1beta2.json
create mode 100644 master/deviceclaim-resource-v1beta2.json
create mode 100644 master/deviceclaimconfiguration-resource-v1beta2.json
create mode 100644 master/deviceclass-resource-v1beta2.json
create mode 100644 master/deviceclassconfiguration-resource-v1beta2.json
create mode 100644 master/deviceclasslist-resource-v1beta2.json
create mode 100644 master/deviceclassspec-resource-v1beta2.json
create mode 100644 master/deviceconstraint-resource-v1beta2.json
create mode 100644 master/devicecounterconsumption-resource-v1beta2.json
create mode 100644 master/devicerequest-resource-v1beta2.json
create mode 100644 master/devicerequestallocationresult-resource-v1beta2.json
create mode 100644 master/deviceselector-resource-v1beta2.json
create mode 100644 master/devicesubrequest-resource-v1beta2.json
create mode 100644 master/devicetaint-resource-v1beta2.json
create mode 100644 master/devicetoleration-resource-v1beta2.json
create mode 100644 master/exactdevicerequest-resource-v1beta2.json
create mode 100644 master/exactdevicerequest.json
create mode 100644 master/networkdevicedata-resource-v1beta2.json
create mode 100644 master/opaquedeviceconfiguration-resource-v1beta2.json
create mode 100644 master/resourceclaim-resource-v1beta2.json
create mode 100644 master/resourceclaimconsumerreference-resource-v1beta2.json
create mode 100644 master/resourceclaimlist-resource-v1beta2.json
create mode 100644 master/resourceclaimspec-resource-v1beta2.json
create mode 100644 master/resourceclaimstatus-resource-v1beta2.json
create mode 100644 master/resourceclaimtemplate-resource-v1beta2.json
create mode 100644 master/resourceclaimtemplatelist-resource-v1beta2.json
create mode 100644 master/resourceclaimtemplatespec-resource-v1beta2.json
create mode 100644 master/resourcepool-resource-v1beta2.json
create mode 100644 master/resourceslice-resource-v1beta2.json
create mode 100644 master/resourceslicelist-resource-v1beta2.json
create mode 100644 master/resourceslicespec-resource-v1beta2.json
diff --git a/master-local/_definitions.json b/master-local/_definitions.json
index 4b629a23e6..5c3d22900f 100644
--- a/master-local/_definitions.json
+++ b/master-local/_definitions.json
@@ -15396,8 +15396,8 @@
"description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
"type": "object"
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -15413,7 +15413,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
@@ -15456,11 +15456,11 @@
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
@@ -15731,20 +15731,20 @@
"io.k8s.api.resource.v1alpha3.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
@@ -15857,7 +15857,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -16553,55 +16553,1078 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.BasicDevice": {
- "description": "BasicDevice defines one device instance.",
+ "io.k8s.api.resource.v1beta1.BasicDevice": {
+ "description": "BasicDevice defines one device instance.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Counter": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CounterSet": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Device": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "basic": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
+ "description": "Basic defines one device instance."
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": "boolean"
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": "string"
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": "string"
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequest": {
+ "description": "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.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "firstAvailable": {
+ "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": "string"
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": "string"
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": "string"
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "pool": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocatedDeviceStatus": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocationResult": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
"properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "boolean"
- },
- "attributes": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "capacity": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
- },
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "string"
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
},
"nodeSelector": {
"$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "io.k8s.api.resource.v1beta2.CELDeviceSelector": {
"description": "CELDeviceSelector contains a CEL expression for selecting a device.",
"properties": {
"expression": {
@@ -16614,7 +17637,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Counter": {
+ "io.k8s.api.resource.v1beta2.Counter": {
"description": "Counter describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16627,14 +17650,14 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CounterSet": {
+ "io.k8s.api.resource.v1beta2.CounterSet": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -16648,16 +17671,54 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Device": {
+ "io.k8s.api.resource.v1beta2.Device": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
"type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16665,11 +17726,11 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration": {
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16690,13 +17751,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationResult": {
"description": "DeviceAllocationResult is the result of allocating devices.",
"properties": {
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16704,7 +17765,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16712,7 +17773,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "io.k8s.api.resource.v1beta2.DeviceAttribute": {
"description": "DeviceAttribute must have exactly one field set.",
"properties": {
"bool": {
@@ -16735,7 +17796,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "io.k8s.api.resource.v1beta2.DeviceCapacity": {
"description": "DeviceCapacity describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16748,13 +17809,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "io.k8s.api.resource.v1beta2.DeviceClaim": {
"description": "DeviceClaim defines how to request devices with a ResourceClaim.",
"properties": {
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16762,7 +17823,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16770,7 +17831,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16778,11 +17839,11 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClaimConfiguration": {
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16796,7 +17857,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "io.k8s.api.resource.v1beta2.DeviceClass": {
"description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -16815,7 +17876,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -16827,21 +17888,21 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClassConfiguration": {
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "io.k8s.api.resource.v1beta2.DeviceClassList": {
"description": "DeviceClassList is a collection of classes.",
"properties": {
"apiVersion": {
@@ -16851,7 +17912,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": "array"
},
@@ -16875,17 +17936,17 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "io.k8s.api.resource.v1beta2.DeviceClassSpec": {
"description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
"properties": {
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16893,7 +17954,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16901,7 +17962,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "io.k8s.api.resource.v1beta2.DeviceConstraint": {
"description": "DeviceConstraint must have exactly one field set besides Requests.",
"properties": {
"matchAttribute": {
@@ -16919,74 +17980,45 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "io.k8s.api.resource.v1beta2.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequest": {
- "description": "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.",
+ "io.k8s.api.resource.v1beta2.DeviceRequest": {
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": "boolean"
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": "string"
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": "integer"
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": "string"
+ "exactly": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16994,7 +18026,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult": {
"description": "DeviceRequestAllocationResult contains the allocation result for one request.",
"properties": {
"adminAccess": {
@@ -17020,7 +18052,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17034,21 +18066,21 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "io.k8s.api.resource.v1beta2.DeviceSelector": {
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "io.k8s.api.resource.v1beta2.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -17067,7 +18099,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17075,7 +18107,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17087,7 +18119,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "io.k8s.api.resource.v1beta2.DeviceTaint": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
"effect": {
@@ -17113,7 +18145,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "io.k8s.api.resource.v1beta2.DeviceToleration": {
"description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
"properties": {
"effect": {
@@ -17140,7 +18172,49 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "io.k8s.api.resource.v1beta2.ExactDeviceRequest": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.NetworkDeviceData": {
"description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
"properties": {
"hardwareAddress": {
@@ -17152,7 +18226,7 @@
"type": "string"
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": "string"
},
@@ -17162,7 +18236,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration": {
"description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
"properties": {
"driver": {
@@ -17180,7 +18254,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "io.k8s.api.resource.v1beta2.ResourceClaim": {
"description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17199,11 +18273,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -17215,11 +18289,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference": {
"description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
"properties": {
"apiGroup": {
@@ -17246,7 +18320,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimList": {
"description": "ResourceClaimList is a collection of claims.",
"properties": {
"apiVersion": {
@@ -17256,7 +18330,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": "array"
},
@@ -17280,31 +18354,31 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimSpec": {
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimStatus": {
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17317,7 +18391,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17330,7 +18404,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplate": {
"description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17349,7 +18423,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -17361,11 +18435,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateList": {
"description": "ResourceClaimTemplateList is a collection of claim templates.",
"properties": {
"apiVersion": {
@@ -17375,7 +18449,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": "array"
},
@@ -17399,11 +18473,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec": {
"description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
"properties": {
"metadata": {
@@ -17411,7 +18485,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
@@ -17420,7 +18494,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "io.k8s.api.resource.v1beta2.ResourcePool": {
"description": "ResourcePool describes the pool that ResourceSlices belong to.",
"properties": {
"generation": {
@@ -17445,7 +18519,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "io.k8s.api.resource.v1beta2.ResourceSlice": {
"description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17464,7 +18538,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -17476,11 +18550,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceList": {
"description": "ResourceSliceList is a collection of ResourceSlices.",
"properties": {
"apiVersion": {
@@ -17490,7 +18564,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": "array"
},
@@ -17514,11 +18588,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceSpec": {
"description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
"properties": {
"allNodes": {
@@ -17528,7 +18602,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17550,13 +18624,13 @@
"type": "boolean"
},
"pool": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -19927,6 +21001,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
@@ -20682,6 +21761,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-local/all.json b/master-local/all.json
index 3e0bb04b13..91d92e58e3 100644
--- a/master-local/all.json
+++ b/master-local/all.json
@@ -1734,6 +1734,123 @@
{
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec"
},
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec"
+ },
{
"$ref": "_definitions.json#/definitions/io.k8s.api.scheduling.v1.PriorityClass"
},
diff --git a/master-local/allocateddevicestatus-resource-v1beta2.json b/master-local/allocateddevicestatus-resource-v1beta2.json
new file mode 100644
index 0000000000..f52d7b431b
--- /dev/null
+++ b/master-local/allocateddevicestatus-resource-v1beta2.json
@@ -0,0 +1,55 @@
+{
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "networkData": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/allocateddevicestatus.json b/master-local/allocateddevicestatus.json
index 6404afb65e..f52d7b431b 100644
--- a/master-local/allocateddevicestatus.json
+++ b/master-local/allocateddevicestatus.json
@@ -34,7 +34,7 @@
]
},
"networkData": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.NetworkDeviceData",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
"description": "NetworkData contains network-related information specific to the device."
},
"pool": {
diff --git a/master-local/allocationresult-resource-v1beta2.json b/master-local/allocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..13563cffbd
--- /dev/null
+++ b/master-local/allocationresult-resource-v1beta2.json
@@ -0,0 +1,15 @@
+{
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
+ },
+ "nodeSelector": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/allocationresult.json b/master-local/allocationresult.json
index 629edb5a8a..13563cffbd 100644
--- a/master-local/allocationresult.json
+++ b/master-local/allocationresult.json
@@ -2,7 +2,7 @@
"description": "AllocationResult contains attributes of an allocated resource.",
"properties": {
"devices": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationResult",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
"description": "Devices is the result of allocating devices."
},
"nodeSelector": {
diff --git a/master-local/basicdevice-resource-v1alpha3.json b/master-local/basicdevice-resource-v1alpha3.json
index cd28df0c74..22ce449c99 100644
--- a/master-local/basicdevice-resource-v1alpha3.json
+++ b/master-local/basicdevice-resource-v1alpha3.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -51,7 +51,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
diff --git a/master-local/basicdevice-resource-v1beta1.json b/master-local/basicdevice-resource-v1beta1.json
index ed88f787da..e284370e5e 100644
--- a/master-local/basicdevice-resource-v1beta1.json
+++ b/master-local/basicdevice-resource-v1beta1.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
},
@@ -48,10 +48,10 @@
},
"nodeSelector": {
"$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
},
diff --git a/master-local/basicdevice.json b/master-local/basicdevice.json
index ed88f787da..e284370e5e 100644
--- a/master-local/basicdevice.json
+++ b/master-local/basicdevice.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
},
@@ -48,10 +48,10 @@
},
"nodeSelector": {
"$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
},
diff --git a/master-local/celdeviceselector-resource-v1beta2.json b/master-local/celdeviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..b63da15344
--- /dev/null
+++ b/master-local/celdeviceselector-resource-v1beta2.json
@@ -0,0 +1,17 @@
+{
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/counter-resource-v1beta2.json b/master-local/counter-resource-v1beta2.json
new file mode 100644
index 0000000000..6bd4e7497e
--- /dev/null
+++ b/master-local/counter-resource-v1beta2.json
@@ -0,0 +1,14 @@
+{
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/counterset-resource-v1alpha3.json b/master-local/counterset-resource-v1alpha3.json
index 7e3a205294..fa78b8cd83 100644
--- a/master-local/counterset-resource-v1alpha3.json
+++ b/master-local/counterset-resource-v1alpha3.json
@@ -5,14 +5,14 @@
"additionalProperties": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": [
"object",
"null"
]
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
"string",
"null"
diff --git a/master-local/counterset-resource-v1beta2.json b/master-local/counterset-resource-v1beta2.json
new file mode 100644
index 0000000000..fb2af40985
--- /dev/null
+++ b/master-local/counterset-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/counterset.json b/master-local/counterset.json
index f15316e2f0..fb2af40985 100644
--- a/master-local/counterset.json
+++ b/master-local/counterset.json
@@ -3,9 +3,9 @@
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": [
"object",
"null"
diff --git a/master-local/deleteoptions-meta-v1.json b/master-local/deleteoptions-meta-v1.json
index 10bb1becc7..758ebed1b8 100644
--- a/master-local/deleteoptions-meta-v1.json
+++ b/master-local/deleteoptions-meta-v1.json
@@ -62,6 +62,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -401,6 +402,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-local/deleteoptions.json b/master-local/deleteoptions.json
index fe068c1654..e642653eb8 100644
--- a/master-local/deleteoptions.json
+++ b/master-local/deleteoptions.json
@@ -338,6 +338,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-local/device-resource-v1beta2.json b/master-local/device-resource-v1beta2.json
new file mode 100644
index 0000000000..7cf7dc4c5d
--- /dev/null
+++ b/master-local/device-resource-v1beta2.json
@@ -0,0 +1,77 @@
+{
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/device.json b/master-local/device.json
index 685ebecff0..7cf7dc4c5d 100644
--- a/master-local/device.json
+++ b/master-local/device.json
@@ -1,9 +1,43 @@
{
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
@@ -11,6 +45,28 @@
"string",
"null"
]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-local/deviceallocationconfiguration-resource-v1beta2.json b/master-local/deviceallocationconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..6cd35a3c40
--- /dev/null
+++ b/master-local/deviceallocationconfiguration-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceallocationconfiguration.json b/master-local/deviceallocationconfiguration.json
index 023be60a0c..6cd35a3c40 100644
--- a/master-local/deviceallocationconfiguration.json
+++ b/master-local/deviceallocationconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
diff --git a/master-local/deviceallocationresult-resource-v1beta2.json b/master-local/deviceallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..3d759a664b
--- /dev/null
+++ b/master-local/deviceallocationresult-resource-v1beta2.json
@@ -0,0 +1,29 @@
+{
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceallocationresult.json b/master-local/deviceallocationresult.json
index 8f324b6af8..3d759a664b 100644
--- a/master-local/deviceallocationresult.json
+++ b/master-local/deviceallocationresult.json
@@ -4,7 +4,7 @@
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": [
"array",
diff --git a/master-local/deviceattribute-resource-v1beta2.json b/master-local/deviceattribute-resource-v1beta2.json
new file mode 100644
index 0000000000..4ad000a165
--- /dev/null
+++ b/master-local/deviceattribute-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicecapacity-resource-v1beta2.json b/master-local/devicecapacity-resource-v1beta2.json
new file mode 100644
index 0000000000..e5f2466ca0
--- /dev/null
+++ b/master-local/devicecapacity-resource-v1beta2.json
@@ -0,0 +1,14 @@
+{
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclaim-resource-v1beta2.json b/master-local/deviceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..e9ab993a5d
--- /dev/null
+++ b/master-local/deviceclaim-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclaim.json b/master-local/deviceclaim.json
index effe18a77c..e9ab993a5d 100644
--- a/master-local/deviceclaim.json
+++ b/master-local/deviceclaim.json
@@ -4,7 +4,7 @@
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": [
"array",
@@ -26,7 +26,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": [
"array",
diff --git a/master-local/deviceclaimconfiguration-resource-v1beta2.json b/master-local/deviceclaimconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..11e49d85ef
--- /dev/null
+++ b/master-local/deviceclaimconfiguration-resource-v1beta2.json
@@ -0,0 +1,25 @@
+{
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclaimconfiguration.json b/master-local/deviceclaimconfiguration.json
index 62ace707d4..11e49d85ef 100644
--- a/master-local/deviceclaimconfiguration.json
+++ b/master-local/deviceclaimconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
diff --git a/master-local/deviceclass-resource-v1beta2.json b/master-local/deviceclass-resource-v1beta2.json
new file mode 100644
index 0000000000..2af183ad60
--- /dev/null
+++ b/master-local/deviceclass-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclass.json b/master-local/deviceclass.json
index 7da3250891..7ebc2eec95 100644
--- a/master-local/deviceclass.json
+++ b/master-local/deviceclass.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/deviceclassconfiguration-resource-v1beta2.json b/master-local/deviceclassconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..a35f9e6d05
--- /dev/null
+++ b/master-local/deviceclassconfiguration-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclassconfiguration.json b/master-local/deviceclassconfiguration.json
index 4115d0f806..a35f9e6d05 100644
--- a/master-local/deviceclassconfiguration.json
+++ b/master-local/deviceclassconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
diff --git a/master-local/deviceclasslist-resource-v1beta2.json b/master-local/deviceclasslist-resource-v1beta2.json
new file mode 100644
index 0000000000..229e24dcd5
--- /dev/null
+++ b/master-local/deviceclasslist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclasslist.json b/master-local/deviceclasslist.json
index 05e232f906..48a1de92ae 100644
--- a/master-local/deviceclasslist.json
+++ b/master-local/deviceclasslist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/deviceclassspec-resource-v1beta2.json b/master-local/deviceclassspec-resource-v1beta2.json
new file mode 100644
index 0000000000..78349edae1
--- /dev/null
+++ b/master-local/deviceclassspec-resource-v1beta2.json
@@ -0,0 +1,29 @@
+{
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceclassspec.json b/master-local/deviceclassspec.json
index e07c8a4227..78349edae1 100644
--- a/master-local/deviceclassspec.json
+++ b/master-local/deviceclassspec.json
@@ -4,7 +4,7 @@
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": [
"array",
diff --git a/master-local/deviceconstraint-resource-v1beta2.json b/master-local/deviceconstraint-resource-v1beta2.json
new file mode 100644
index 0000000000..9603a6111e
--- /dev/null
+++ b/master-local/deviceconstraint-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicecounterconsumption-resource-v1alpha3.json b/master-local/devicecounterconsumption-resource-v1alpha3.json
index c80a08d86e..b2fa9afdcd 100644
--- a/master-local/devicecounterconsumption-resource-v1alpha3.json
+++ b/master-local/devicecounterconsumption-resource-v1alpha3.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-local/devicecounterconsumption-resource-v1beta1.json b/master-local/devicecounterconsumption-resource-v1beta1.json
index b008d8cc27..c971ad1cec 100644
--- a/master-local/devicecounterconsumption-resource-v1beta1.json
+++ b/master-local/devicecounterconsumption-resource-v1beta1.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-local/devicecounterconsumption-resource-v1beta2.json b/master-local/devicecounterconsumption-resource-v1beta2.json
new file mode 100644
index 0000000000..f649d469b9
--- /dev/null
+++ b/master-local/devicecounterconsumption-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicecounterconsumption.json b/master-local/devicecounterconsumption.json
index b008d8cc27..f649d469b9 100644
--- a/master-local/devicecounterconsumption.json
+++ b/master-local/devicecounterconsumption.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
- "counters": {
- "additionalProperties": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
- },
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
- "object",
+ "string",
"null"
]
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
+ "counters": {
+ "additionalProperties": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
- "string",
+ "object",
"null"
]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-local/devicerequest-resource-v1beta2.json b/master-local/devicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..a70af1afc6
--- /dev/null
+++ b/master-local/devicerequest-resource-v1beta2.json
@@ -0,0 +1,32 @@
+{
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicerequest.json b/master-local/devicerequest.json
index d90dcf8c8c..a70af1afc6 100644
--- a/master-local/devicerequest.json
+++ b/master-local/devicerequest.json
@@ -1,39 +1,14 @@
{
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": [
- "string",
- "null"
- ]
+ "exactly": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": [
"array",
@@ -42,33 +17,11 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": [
"string",
"null"
]
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-local/devicerequestallocationresult-resource-v1beta2.json b/master-local/devicerequestallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..dbf204dcb2
--- /dev/null
+++ b/master-local/devicerequestallocationresult-resource-v1beta2.json
@@ -0,0 +1,59 @@
+{
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicerequestallocationresult.json b/master-local/devicerequestallocationresult.json
index 2cb283c5f6..dbf204dcb2 100644
--- a/master-local/devicerequestallocationresult.json
+++ b/master-local/devicerequestallocationresult.json
@@ -39,7 +39,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": [
"array",
diff --git a/master-local/deviceselector-resource-v1beta2.json b/master-local/deviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..d854277b04
--- /dev/null
+++ b/master-local/deviceselector-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/deviceselector.json b/master-local/deviceselector.json
index 83ff57b9ef..d854277b04 100644
--- a/master-local/deviceselector.json
+++ b/master-local/deviceselector.json
@@ -2,7 +2,7 @@
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
diff --git a/master-local/devicesubrequest-resource-v1alpha3.json b/master-local/devicesubrequest-resource-v1alpha3.json
index a8516dc75b..0fa23da0fc 100644
--- a/master-local/devicesubrequest-resource-v1alpha3.json
+++ b/master-local/devicesubrequest-resource-v1alpha3.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-local/devicesubrequest-resource-v1beta1.json b/master-local/devicesubrequest-resource-v1beta1.json
index 989d211395..770b5d52f1 100644
--- a/master-local/devicesubrequest-resource-v1beta1.json
+++ b/master-local/devicesubrequest-resource-v1beta1.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-local/devicesubrequest-resource-v1beta2.json b/master-local/devicesubrequest-resource-v1beta2.json
new file mode 100644
index 0000000000..f1b5bf8485
--- /dev/null
+++ b/master-local/devicesubrequest-resource-v1beta2.json
@@ -0,0 +1,62 @@
+{
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicesubrequest.json b/master-local/devicesubrequest.json
index 989d211395..f1b5bf8485 100644
--- a/master-local/devicesubrequest.json
+++ b/master-local/devicesubrequest.json
@@ -1,8 +1,8 @@
{
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -33,7 +33,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": [
"array",
@@ -44,7 +44,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": [
"array",
diff --git a/master-local/devicetaint-resource-v1beta2.json b/master-local/devicetaint-resource-v1beta2.json
new file mode 100644
index 0000000000..6da7aff1a6
--- /dev/null
+++ b/master-local/devicetaint-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "timeAdded": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/devicetoleration-resource-v1beta2.json b/master-local/devicetoleration-resource-v1beta2.json
new file mode 100644
index 0000000000..8fb10b765d
--- /dev/null
+++ b/master-local/devicetoleration-resource-v1beta2.json
@@ -0,0 +1,43 @@
+{
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/exactdevicerequest-resource-v1beta2.json b/master-local/exactdevicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..aa4224bcea
--- /dev/null
+++ b/master-local/exactdevicerequest-resource-v1beta2.json
@@ -0,0 +1,61 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/exactdevicerequest.json b/master-local/exactdevicerequest.json
new file mode 100644
index 0000000000..aa4224bcea
--- /dev/null
+++ b/master-local/exactdevicerequest.json
@@ -0,0 +1,61 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/networkdevicedata-resource-v1beta2.json b/master-local/networkdevicedata-resource-v1beta2.json
new file mode 100644
index 0000000000..b291f267e3
--- /dev/null
+++ b/master-local/networkdevicedata-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/networkdevicedata.json b/master-local/networkdevicedata.json
index ea6cc68bbd..b291f267e3 100644
--- a/master-local/networkdevicedata.json
+++ b/master-local/networkdevicedata.json
@@ -16,7 +16,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-local/opaquedeviceconfiguration-resource-v1beta2.json b/master-local/opaquedeviceconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..3c9faca426
--- /dev/null
+++ b/master-local/opaquedeviceconfiguration-resource-v1beta2.json
@@ -0,0 +1,22 @@
+{
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parameters": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaim-resource-v1beta2.json b/master-local/resourceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..1d243a8ae2
--- /dev/null
+++ b/master-local/resourceclaim-resource-v1beta2.json
@@ -0,0 +1,49 @@
+{
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaim.json b/master-local/resourceclaim.json
index 3bd4e70028..75df36e8cf 100644
--- a/master-local/resourceclaim.json
+++ b/master-local/resourceclaim.json
@@ -23,11 +23,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -39,7 +39,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceclaimconsumerreference-resource-v1beta2.json b/master-local/resourceclaimconsumerreference-resource-v1beta2.json
new file mode 100644
index 0000000000..c7b403264b
--- /dev/null
+++ b/master-local/resourceclaimconsumerreference-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimlist-resource-v1beta2.json b/master-local/resourceclaimlist-resource-v1beta2.json
new file mode 100644
index 0000000000..deb2f1ac98
--- /dev/null
+++ b/master-local/resourceclaimlist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimlist.json b/master-local/resourceclaimlist.json
index 949c6c2404..49ca6f9c13 100644
--- a/master-local/resourceclaimlist.json
+++ b/master-local/resourceclaimlist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceclaimspec-resource-v1beta2.json b/master-local/resourceclaimspec-resource-v1beta2.json
new file mode 100644
index 0000000000..24e5347f90
--- /dev/null
+++ b/master-local/resourceclaimspec-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimspec.json b/master-local/resourceclaimspec.json
index a70ab22f13..24e5347f90 100644
--- a/master-local/resourceclaimspec.json
+++ b/master-local/resourceclaimspec.json
@@ -2,7 +2,7 @@
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
diff --git a/master-local/resourceclaimstatus-resource-v1beta2.json b/master-local/resourceclaimstatus-resource-v1beta2.json
new file mode 100644
index 0000000000..da00a045b3
--- /dev/null
+++ b/master-local/resourceclaimstatus-resource-v1beta2.json
@@ -0,0 +1,43 @@
+{
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimstatus.json b/master-local/resourceclaimstatus.json
index 0834d8f68b..da00a045b3 100644
--- a/master-local/resourceclaimstatus.json
+++ b/master-local/resourceclaimstatus.json
@@ -2,13 +2,13 @@
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": [
"array",
@@ -24,7 +24,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": [
"array",
diff --git a/master-local/resourceclaimtemplate-resource-v1beta2.json b/master-local/resourceclaimtemplate-resource-v1beta2.json
new file mode 100644
index 0000000000..907eb0d226
--- /dev/null
+++ b/master-local/resourceclaimtemplate-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimtemplate.json b/master-local/resourceclaimtemplate.json
index 2719870b3b..09b579d853 100644
--- a/master-local/resourceclaimtemplate.json
+++ b/master-local/resourceclaimtemplate.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceclaimtemplatelist-resource-v1beta2.json b/master-local/resourceclaimtemplatelist-resource-v1beta2.json
new file mode 100644
index 0000000000..77db8f9d3b
--- /dev/null
+++ b/master-local/resourceclaimtemplatelist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimtemplatelist.json b/master-local/resourceclaimtemplatelist.json
index 6a7d1d1fa8..8ccdf6c3f8 100644
--- a/master-local/resourceclaimtemplatelist.json
+++ b/master-local/resourceclaimtemplatelist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceclaimtemplatespec-resource-v1beta2.json b/master-local/resourceclaimtemplatespec-resource-v1beta2.json
new file mode 100644
index 0000000000..43f0c34533
--- /dev/null
+++ b/master-local/resourceclaimtemplatespec-resource-v1beta2.json
@@ -0,0 +1,18 @@
+{
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceclaimtemplatespec.json b/master-local/resourceclaimtemplatespec.json
index f20be6fa24..43f0c34533 100644
--- a/master-local/resourceclaimtemplatespec.json
+++ b/master-local/resourceclaimtemplatespec.json
@@ -6,7 +6,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
diff --git a/master-local/resourcepool-resource-v1beta2.json b/master-local/resourcepool-resource-v1beta2.json
new file mode 100644
index 0000000000..c85bd4c5ed
--- /dev/null
+++ b/master-local/resourcepool-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceslice-resource-v1beta2.json b/master-local/resourceslice-resource-v1beta2.json
new file mode 100644
index 0000000000..240a3ef4e5
--- /dev/null
+++ b/master-local/resourceslice-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceslice.json b/master-local/resourceslice.json
index 7f2c3fe986..a72a21561e 100644
--- a/master-local/resourceslice.json
+++ b/master-local/resourceslice.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceslicelist-resource-v1beta2.json b/master-local/resourceslicelist-resource-v1beta2.json
new file mode 100644
index 0000000000..dd27af4c98
--- /dev/null
+++ b/master-local/resourceslicelist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceslicelist.json b/master-local/resourceslicelist.json
index df04ee9610..a4a1d3a76c 100644
--- a/master-local/resourceslicelist.json
+++ b/master-local/resourceslicelist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-local/resourceslicespec-resource-v1beta2.json b/master-local/resourceslicespec-resource-v1beta2.json
new file mode 100644
index 0000000000..110fea97f3
--- /dev/null
+++ b/master-local/resourceslicespec-resource-v1beta2.json
@@ -0,0 +1,69 @@
+{
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-local/resourceslicespec.json b/master-local/resourceslicespec.json
index 9fcf4e502c..110fea97f3 100644
--- a/master-local/resourceslicespec.json
+++ b/master-local/resourceslicespec.json
@@ -11,7 +11,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": [
"array",
@@ -45,13 +45,13 @@
]
},
"pool": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": [
"array",
diff --git a/master-local/watchevent-meta-v1.json b/master-local/watchevent-meta-v1.json
index 7af2d18273..04b16e0ceb 100644
--- a/master-local/watchevent-meta-v1.json
+++ b/master-local/watchevent-meta-v1.json
@@ -288,6 +288,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-local/watchevent.json b/master-local/watchevent.json
index 7af2d18273..04b16e0ceb 100644
--- a/master-local/watchevent.json
+++ b/master-local/watchevent.json
@@ -288,6 +288,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone-strict/_definitions.json b/master-standalone-strict/_definitions.json
index 50284e51a4..40300dc8fd 100644
--- a/master-standalone-strict/_definitions.json
+++ b/master-standalone-strict/_definitions.json
@@ -15894,8 +15894,8 @@
"description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
"type": "object"
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -15911,7 +15911,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
@@ -15957,11 +15957,11 @@
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
@@ -16244,20 +16244,20 @@
"io.k8s.api.resource.v1alpha3.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
@@ -16374,7 +16374,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -17107,42 +17107,1103 @@
"description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
"type": "object"
},
- "capacity": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
- },
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.Counter": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.CounterSet": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.Device": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "basic": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
+ "description": "Basic defines one device instance."
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": "boolean"
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": "string"
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": "string"
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequest": {
+ "description": "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.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "firstAvailable": {
+ "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": "string"
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": "string"
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": "string"
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta1"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "pool": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta2.AllocatedDeviceStatus": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
+ "networkData": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
},
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
"type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta2.AllocationResult": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
},
"nodeSelector": {
"$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
}
},
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "io.k8s.api.resource.v1beta2.CELDeviceSelector": {
"description": "CELDeviceSelector contains a CEL expression for selecting a device.",
"properties": {
"expression": {
@@ -17156,7 +18217,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.Counter": {
+ "io.k8s.api.resource.v1beta2.Counter": {
"description": "Counter describes a quantity associated with a device.",
"properties": {
"value": {
@@ -17170,14 +18231,14 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.CounterSet": {
+ "io.k8s.api.resource.v1beta2.CounterSet": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -17192,16 +18253,54 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.Device": {
+ "io.k8s.api.resource.v1beta2.Device": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
"type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -17210,11 +18309,11 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration": {
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -17236,13 +18335,13 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationResult": {
"description": "DeviceAllocationResult is the result of allocating devices.",
"properties": {
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17250,7 +18349,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17259,7 +18358,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "io.k8s.api.resource.v1beta2.DeviceAttribute": {
"description": "DeviceAttribute must have exactly one field set.",
"properties": {
"bool": {
@@ -17283,7 +18382,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "io.k8s.api.resource.v1beta2.DeviceCapacity": {
"description": "DeviceCapacity describes a quantity associated with a device.",
"properties": {
"value": {
@@ -17297,13 +18396,13 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "io.k8s.api.resource.v1beta2.DeviceClaim": {
"description": "DeviceClaim defines how to request devices with a ResourceClaim.",
"properties": {
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17311,7 +18410,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17319,7 +18418,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17328,11 +18427,11 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClaimConfiguration": {
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -17347,7 +18446,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "io.k8s.api.resource.v1beta2.DeviceClass": {
"description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17366,7 +18465,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -17378,23 +18477,23 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClassConfiguration": {
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "io.k8s.api.resource.v1beta2.DeviceClassList": {
"description": "DeviceClassList is a collection of classes.",
"properties": {
"apiVersion": {
@@ -17404,7 +18503,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": "array"
},
@@ -17428,18 +18527,18 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "io.k8s.api.resource.v1beta2.DeviceClassSpec": {
"description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
"properties": {
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17447,7 +18546,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17456,7 +18555,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "io.k8s.api.resource.v1beta2.DeviceConstraint": {
"description": "DeviceConstraint must have exactly one field set besides Requests.",
"properties": {
"matchAttribute": {
@@ -17475,75 +18574,46 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "io.k8s.api.resource.v1beta2.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceRequest": {
- "description": "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.",
+ "io.k8s.api.resource.v1beta2.DeviceRequest": {
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": "boolean"
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": "string"
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": "integer"
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": "string"
+ "exactly": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -17552,7 +18622,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult": {
"description": "DeviceRequestAllocationResult contains the allocation result for one request.",
"properties": {
"adminAccess": {
@@ -17578,7 +18648,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17593,22 +18663,22 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "io.k8s.api.resource.v1beta2.DeviceSelector": {
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "io.k8s.api.resource.v1beta2.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -17627,7 +18697,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17635,7 +18705,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17648,7 +18718,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "io.k8s.api.resource.v1beta2.DeviceTaint": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
"effect": {
@@ -17675,7 +18745,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "io.k8s.api.resource.v1beta2.DeviceToleration": {
"description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
"properties": {
"effect": {
@@ -17703,7 +18773,50 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "io.k8s.api.resource.v1beta2.ExactDeviceRequest": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "io.k8s.api.resource.v1beta2.NetworkDeviceData": {
"description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
"properties": {
"hardwareAddress": {
@@ -17715,7 +18828,7 @@
"type": "string"
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": "string"
},
@@ -17726,7 +18839,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration": {
"description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
"properties": {
"driver": {
@@ -17745,7 +18858,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "io.k8s.api.resource.v1beta2.ResourceClaim": {
"description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17764,11 +18877,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -17780,12 +18893,12 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference": {
"description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
"properties": {
"apiGroup": {
@@ -17813,7 +18926,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimList": {
"description": "ResourceClaimList is a collection of claims.",
"properties": {
"apiVersion": {
@@ -17823,7 +18936,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": "array"
},
@@ -17847,33 +18960,33 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimSpec": {
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimStatus": {
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17886,7 +18999,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17900,7 +19013,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplate": {
"description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17919,7 +19032,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -17931,12 +19044,12 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateList": {
"description": "ResourceClaimTemplateList is a collection of claim templates.",
"properties": {
"apiVersion": {
@@ -17946,7 +19059,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": "array"
},
@@ -17970,12 +19083,12 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec": {
"description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
"properties": {
"metadata": {
@@ -17983,7 +19096,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
@@ -17993,7 +19106,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "io.k8s.api.resource.v1beta2.ResourcePool": {
"description": "ResourcePool describes the pool that ResourceSlices belong to.",
"properties": {
"generation": {
@@ -18019,7 +19132,7 @@
"type": "object",
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "io.k8s.api.resource.v1beta2.ResourceSlice": {
"description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -18038,7 +19151,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -18050,12 +19163,12 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceList": {
"description": "ResourceSliceList is a collection of ResourceSlices.",
"properties": {
"apiVersion": {
@@ -18065,7 +19178,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": "array"
},
@@ -18089,12 +19202,12 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
},
- "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceSpec": {
"description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
"properties": {
"allNodes": {
@@ -18104,7 +19217,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -18126,13 +19239,13 @@
"type": "boolean"
},
"pool": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -20560,6 +21673,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
@@ -21329,6 +22447,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone-strict/all.json b/master-standalone-strict/all.json
index 3e0bb04b13..91d92e58e3 100644
--- a/master-standalone-strict/all.json
+++ b/master-standalone-strict/all.json
@@ -1734,6 +1734,123 @@
{
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec"
},
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec"
+ },
{
"$ref": "_definitions.json#/definitions/io.k8s.api.scheduling.v1.PriorityClass"
},
diff --git a/master-standalone-strict/allocateddevicestatus-resource-v1beta2.json b/master-standalone-strict/allocateddevicestatus-resource-v1beta2.json
new file mode 100644
index 0000000000..0804d33e7b
--- /dev/null
+++ b/master-standalone-strict/allocateddevicestatus-resource-v1beta2.json
@@ -0,0 +1,136 @@
+{
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/allocateddevicestatus.json b/master-standalone-strict/allocateddevicestatus.json
index d94aaff17f..0804d33e7b 100644
--- a/master-standalone-strict/allocateddevicestatus.json
+++ b/master-standalone-strict/allocateddevicestatus.json
@@ -97,7 +97,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone-strict/allocationresult-resource-v1beta2.json b/master-standalone-strict/allocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..3615916cb4
--- /dev/null
+++ b/master-standalone-strict/allocationresult-resource-v1beta2.json
@@ -0,0 +1,298 @@
+{
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/basicdevice-resource-v1alpha3.json b/master-standalone-strict/basicdevice-resource-v1alpha3.json
index ad6abd3f66..03c1779c83 100644
--- a/master-standalone-strict/basicdevice-resource-v1alpha3.json
+++ b/master-standalone-strict/basicdevice-resource-v1alpha3.json
@@ -77,11 +77,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -112,16 +116,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -262,7 +262,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/basicdevice-resource-v1beta1.json b/master-standalone-strict/basicdevice-resource-v1beta1.json
index af13ad852c..ecf3764eb0 100644
--- a/master-standalone-strict/basicdevice-resource-v1beta1.json
+++ b/master-standalone-strict/basicdevice-resource-v1beta1.json
@@ -90,11 +90,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -125,16 +129,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -275,7 +275,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/basicdevice.json b/master-standalone-strict/basicdevice.json
index af13ad852c..ecf3764eb0 100644
--- a/master-standalone-strict/basicdevice.json
+++ b/master-standalone-strict/basicdevice.json
@@ -90,11 +90,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -125,16 +129,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -275,7 +275,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/celdeviceselector-resource-v1beta2.json b/master-standalone-strict/celdeviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..eabb5285d8
--- /dev/null
+++ b/master-standalone-strict/celdeviceselector-resource-v1beta2.json
@@ -0,0 +1,18 @@
+{
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/counter-resource-v1beta2.json b/master-standalone-strict/counter-resource-v1beta2.json
new file mode 100644
index 0000000000..a8b3625974
--- /dev/null
+++ b/master-standalone-strict/counter-resource-v1beta2.json
@@ -0,0 +1,27 @@
+{
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/counterset-resource-v1alpha3.json b/master-standalone-strict/counterset-resource-v1alpha3.json
index 9642611d56..a4f6e7e29a 100644
--- a/master-standalone-strict/counterset-resource-v1alpha3.json
+++ b/master-standalone-strict/counterset-resource-v1alpha3.json
@@ -31,14 +31,14 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": [
"object",
"null"
]
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/counterset-resource-v1beta2.json b/master-standalone-strict/counterset-resource-v1beta2.json
new file mode 100644
index 0000000000..bf7c334cde
--- /dev/null
+++ b/master-standalone-strict/counterset-resource-v1beta2.json
@@ -0,0 +1,55 @@
+{
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/counterset.json b/master-standalone-strict/counterset.json
index 9b9a04d05b..bf7c334cde 100644
--- a/master-standalone-strict/counterset.json
+++ b/master-standalone-strict/counterset.json
@@ -31,7 +31,7 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": [
"object",
"null"
diff --git a/master-standalone-strict/deleteoptions-meta-v1.json b/master-standalone-strict/deleteoptions-meta-v1.json
index 222c72e2b7..b7a0b3893b 100644
--- a/master-standalone-strict/deleteoptions-meta-v1.json
+++ b/master-standalone-strict/deleteoptions-meta-v1.json
@@ -62,6 +62,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -421,6 +422,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone-strict/deleteoptions.json b/master-standalone-strict/deleteoptions.json
index 6bf4acd4a0..c8e41fab6c 100644
--- a/master-standalone-strict/deleteoptions.json
+++ b/master-standalone-strict/deleteoptions.json
@@ -358,6 +358,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone-strict/device-resource-v1alpha3.json b/master-standalone-strict/device-resource-v1alpha3.json
index 15a44a91c4..31a4d52c4f 100644
--- a/master-standalone-strict/device-resource-v1alpha3.json
+++ b/master-standalone-strict/device-resource-v1alpha3.json
@@ -80,11 +80,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -115,16 +119,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -265,7 +265,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/device-resource-v1beta1.json b/master-standalone-strict/device-resource-v1beta1.json
index 8320d80ad4..b8b21e703f 100644
--- a/master-standalone-strict/device-resource-v1beta1.json
+++ b/master-standalone-strict/device-resource-v1beta1.json
@@ -93,11 +93,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -128,16 +132,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -278,7 +278,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/device-resource-v1beta2.json b/master-standalone-strict/device-resource-v1beta2.json
new file mode 100644
index 0000000000..643d4114d3
--- /dev/null
+++ b/master-standalone-strict/device-resource-v1beta2.json
@@ -0,0 +1,336 @@
+{
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/device.json b/master-standalone-strict/device.json
index 8320d80ad4..643d4114d3 100644
--- a/master-standalone-strict/device.json
+++ b/master-standalone-strict/device.json
@@ -1,126 +1,207 @@
{
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
@@ -128,213 +209,122 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
"type": [
- "string",
+ "array",
"null"
- ]
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone-strict/deviceallocationconfiguration-resource-v1beta2.json b/master-standalone-strict/deviceallocationconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..f22700bfaa
--- /dev/null
+++ b/master-standalone-strict/deviceallocationconfiguration-resource-v1beta2.json
@@ -0,0 +1,54 @@
+{
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceallocationresult-resource-v1beta2.json b/master-standalone-strict/deviceallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..3cb59a8bd6
--- /dev/null
+++ b/master-standalone-strict/deviceallocationresult-resource-v1beta2.json
@@ -0,0 +1,170 @@
+{
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceattribute-resource-v1beta2.json b/master-standalone-strict/deviceattribute-resource-v1beta2.json
new file mode 100644
index 0000000000..70675af56b
--- /dev/null
+++ b/master-standalone-strict/deviceattribute-resource-v1beta2.json
@@ -0,0 +1,37 @@
+{
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicecapacity-resource-v1beta2.json b/master-standalone-strict/devicecapacity-resource-v1beta2.json
new file mode 100644
index 0000000000..c2c3c926f6
--- /dev/null
+++ b/master-standalone-strict/devicecapacity-resource-v1beta2.json
@@ -0,0 +1,27 @@
+{
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclaim-resource-v1alpha3.json b/master-standalone-strict/deviceclaim-resource-v1alpha3.json
index 3354cd7140..542db84503 100644
--- a/master-standalone-strict/deviceclaim-resource-v1alpha3.json
+++ b/master-standalone-strict/deviceclaim-resource-v1alpha3.json
@@ -134,7 +134,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/deviceclaim-resource-v1beta1.json b/master-standalone-strict/deviceclaim-resource-v1beta1.json
index 80aa09014a..7d61c0d427 100644
--- a/master-standalone-strict/deviceclaim-resource-v1beta1.json
+++ b/master-standalone-strict/deviceclaim-resource-v1beta1.json
@@ -134,7 +134,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/deviceclaim-resource-v1beta2.json b/master-standalone-strict/deviceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..d83dbe728c
--- /dev/null
+++ b/master-standalone-strict/deviceclaim-resource-v1beta2.json
@@ -0,0 +1,388 @@
+{
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclaim.json b/master-standalone-strict/deviceclaim.json
index 80aa09014a..d83dbe728c 100644
--- a/master-standalone-strict/deviceclaim.json
+++ b/master-standalone-strict/deviceclaim.json
@@ -97,44 +97,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -263,97 +362,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone-strict/deviceclaimconfiguration-resource-v1beta2.json b/master-standalone-strict/deviceclaimconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..293c8ea62e
--- /dev/null
+++ b/master-standalone-strict/deviceclaimconfiguration-resource-v1beta2.json
@@ -0,0 +1,44 @@
+{
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclass-resource-v1beta2.json b/master-standalone-strict/deviceclass-resource-v1beta2.json
new file mode 100644
index 0000000000..87def807fc
--- /dev/null
+++ b/master-standalone-strict/deviceclass-resource-v1beta2.json
@@ -0,0 +1,376 @@
+{
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclass.json b/master-standalone-strict/deviceclass.json
index 143cca5197..8f6437caf7 100644
--- a/master-standalone-strict/deviceclass.json
+++ b/master-standalone-strict/deviceclass.json
@@ -365,7 +365,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/deviceclassconfiguration-resource-v1beta2.json b/master-standalone-strict/deviceclassconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..8c694881df
--- /dev/null
+++ b/master-standalone-strict/deviceclassconfiguration-resource-v1beta2.json
@@ -0,0 +1,30 @@
+{
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclasslist-resource-v1beta2.json b/master-standalone-strict/deviceclasslist-resource-v1beta2.json
new file mode 100644
index 0000000000..4e4f7097ad
--- /dev/null
+++ b/master-standalone-strict/deviceclasslist-resource-v1beta2.json
@@ -0,0 +1,459 @@
+{
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceclasslist.json b/master-standalone-strict/deviceclasslist.json
index b99b3edf6d..9e0ae569e7 100644
--- a/master-standalone-strict/deviceclasslist.json
+++ b/master-standalone-strict/deviceclasslist.json
@@ -377,7 +377,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
@@ -445,7 +445,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/deviceclassspec-resource-v1beta2.json b/master-standalone-strict/deviceclassspec-resource-v1beta2.json
new file mode 100644
index 0000000000..b1cf732779
--- /dev/null
+++ b/master-standalone-strict/deviceclassspec-resource-v1beta2.json
@@ -0,0 +1,83 @@
+{
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceconstraint-resource-v1beta2.json b/master-standalone-strict/deviceconstraint-resource-v1beta2.json
new file mode 100644
index 0000000000..c3848c618b
--- /dev/null
+++ b/master-standalone-strict/deviceconstraint-resource-v1beta2.json
@@ -0,0 +1,29 @@
+{
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicecounterconsumption-resource-v1alpha3.json b/master-standalone-strict/devicecounterconsumption-resource-v1alpha3.json
index 1b8ea59faa..b863176b55 100644
--- a/master-standalone-strict/devicecounterconsumption-resource-v1alpha3.json
+++ b/master-standalone-strict/devicecounterconsumption-resource-v1alpha3.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -31,22 +38,15 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone-strict/devicecounterconsumption-resource-v1beta1.json b/master-standalone-strict/devicecounterconsumption-resource-v1beta1.json
index 1b8ea59faa..58f12bcd56 100644
--- a/master-standalone-strict/devicecounterconsumption-resource-v1beta1.json
+++ b/master-standalone-strict/devicecounterconsumption-resource-v1beta1.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -31,22 +38,15 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone-strict/devicecounterconsumption-resource-v1beta2.json b/master-standalone-strict/devicecounterconsumption-resource-v1beta2.json
new file mode 100644
index 0000000000..58f12bcd56
--- /dev/null
+++ b/master-standalone-strict/devicecounterconsumption-resource-v1beta2.json
@@ -0,0 +1,55 @@
+{
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicecounterconsumption.json b/master-standalone-strict/devicecounterconsumption.json
index 1b8ea59faa..58f12bcd56 100644
--- a/master-standalone-strict/devicecounterconsumption.json
+++ b/master-standalone-strict/devicecounterconsumption.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -31,22 +38,15 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone-strict/devicerequest-resource-v1alpha3.json b/master-standalone-strict/devicerequest-resource-v1alpha3.json
index ffb4339b70..1f7aff35a5 100644
--- a/master-standalone-strict/devicerequest-resource-v1alpha3.json
+++ b/master-standalone-strict/devicerequest-resource-v1alpha3.json
@@ -36,7 +36,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/devicerequest-resource-v1beta1.json b/master-standalone-strict/devicerequest-resource-v1beta1.json
index 457606decf..8906c4a7c0 100644
--- a/master-standalone-strict/devicerequest-resource-v1beta1.json
+++ b/master-standalone-strict/devicerequest-resource-v1beta1.json
@@ -36,7 +36,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/devicerequest-resource-v1beta2.json b/master-standalone-strict/devicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..a66443d180
--- /dev/null
+++ b/master-standalone-strict/devicerequest-resource-v1beta2.json
@@ -0,0 +1,280 @@
+{
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicerequest.json b/master-standalone-strict/devicerequest.json
index 457606decf..a66443d180 100644
--- a/master-standalone-strict/devicerequest.json
+++ b/master-standalone-strict/devicerequest.json
@@ -1,42 +1,141 @@
{
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -165,100 +264,11 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": [
"string",
"null"
]
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone-strict/devicerequestallocationresult-resource-v1beta2.json b/master-standalone-strict/devicerequestallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..1a9083e71b
--- /dev/null
+++ b/master-standalone-strict/devicerequestallocationresult-resource-v1beta2.json
@@ -0,0 +1,103 @@
+{
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/deviceselector-resource-v1beta2.json b/master-standalone-strict/deviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..b18fa092d6
--- /dev/null
+++ b/master-standalone-strict/deviceselector-resource-v1beta2.json
@@ -0,0 +1,25 @@
+{
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicesubrequest-resource-v1alpha3.json b/master-standalone-strict/devicesubrequest-resource-v1alpha3.json
index 0eec2c6b64..4942612ca0 100644
--- a/master-standalone-strict/devicesubrequest-resource-v1alpha3.json
+++ b/master-standalone-strict/devicesubrequest-resource-v1alpha3.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/devicesubrequest-resource-v1beta1.json b/master-standalone-strict/devicesubrequest-resource-v1beta1.json
index 0153401c73..f637ed4a33 100644
--- a/master-standalone-strict/devicesubrequest-resource-v1beta1.json
+++ b/master-standalone-strict/devicesubrequest-resource-v1beta1.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/devicesubrequest-resource-v1beta2.json b/master-standalone-strict/devicesubrequest-resource-v1beta2.json
new file mode 100644
index 0000000000..8506d28974
--- /dev/null
+++ b/master-standalone-strict/devicesubrequest-resource-v1beta2.json
@@ -0,0 +1,130 @@
+{
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicesubrequest.json b/master-standalone-strict/devicesubrequest.json
index 0153401c73..8506d28974 100644
--- a/master-standalone-strict/devicesubrequest.json
+++ b/master-standalone-strict/devicesubrequest.json
@@ -1,8 +1,8 @@
{
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/devicetaint-resource-v1beta2.json b/master-standalone-strict/devicetaint-resource-v1beta2.json
new file mode 100644
index 0000000000..57ed9da9d5
--- /dev/null
+++ b/master-standalone-strict/devicetaint-resource-v1beta2.json
@@ -0,0 +1,41 @@
+{
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/devicetoleration-resource-v1beta2.json b/master-standalone-strict/devicetoleration-resource-v1beta2.json
new file mode 100644
index 0000000000..6c55784fc3
--- /dev/null
+++ b/master-standalone-strict/devicetoleration-resource-v1beta2.json
@@ -0,0 +1,44 @@
+{
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/eviction-policy-v1.json b/master-standalone-strict/eviction-policy-v1.json
index 7753238be1..8c0818b09c 100644
--- a/master-standalone-strict/eviction-policy-v1.json
+++ b/master-standalone-strict/eviction-policy-v1.json
@@ -75,6 +75,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -437,6 +438,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone-strict/eviction.json b/master-standalone-strict/eviction.json
index b59290c360..21bc830669 100644
--- a/master-standalone-strict/eviction.json
+++ b/master-standalone-strict/eviction.json
@@ -371,6 +371,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone-strict/exactdevicerequest-resource-v1beta2.json b/master-standalone-strict/exactdevicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..4eb44bc65e
--- /dev/null
+++ b/master-standalone-strict/exactdevicerequest-resource-v1beta2.json
@@ -0,0 +1,129 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/exactdevicerequest.json b/master-standalone-strict/exactdevicerequest.json
new file mode 100644
index 0000000000..4eb44bc65e
--- /dev/null
+++ b/master-standalone-strict/exactdevicerequest.json
@@ -0,0 +1,129 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/networkdevicedata-resource-v1beta2.json b/master-standalone-strict/networkdevicedata-resource-v1beta2.json
new file mode 100644
index 0000000000..3f77a4acc6
--- /dev/null
+++ b/master-standalone-strict/networkdevicedata-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/networkdevicedata.json b/master-standalone-strict/networkdevicedata.json
index 17b7f7fd5b..3f77a4acc6 100644
--- a/master-standalone-strict/networkdevicedata.json
+++ b/master-standalone-strict/networkdevicedata.json
@@ -16,7 +16,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone-strict/opaquedeviceconfiguration-resource-v1beta2.json b/master-standalone-strict/opaquedeviceconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..b005459250
--- /dev/null
+++ b/master-standalone-strict/opaquedeviceconfiguration-resource-v1beta2.json
@@ -0,0 +1,26 @@
+{
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaim-resource-v1alpha3.json b/master-standalone-strict/resourceclaim-resource-v1alpha3.json
index 43f1062184..df995350d4 100644
--- a/master-standalone-strict/resourceclaim-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaim-resource-v1alpha3.json
@@ -413,7 +413,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaim-resource-v1beta1.json b/master-standalone-strict/resourceclaim-resource-v1beta1.json
index 6bd20a3a33..225855b8c5 100644
--- a/master-standalone-strict/resourceclaim-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaim-resource-v1beta1.json
@@ -413,7 +413,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaim-resource-v1beta2.json b/master-standalone-strict/resourceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..bcf1a5a133
--- /dev/null
+++ b/master-standalone-strict/resourceclaim-resource-v1beta2.json
@@ -0,0 +1,1190 @@
+{
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "status": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaim.json b/master-standalone-strict/resourceclaim.json
index de9d128276..c94358b7c4 100644
--- a/master-standalone-strict/resourceclaim.json
+++ b/master-standalone-strict/resourceclaim.json
@@ -373,44 +373,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -539,97 +638,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -1059,7 +1069,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
@@ -1169,7 +1179,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceclaimconsumerreference-resource-v1beta2.json b/master-standalone-strict/resourceclaimconsumerreference-resource-v1beta2.json
new file mode 100644
index 0000000000..6e084cd1a2
--- /dev/null
+++ b/master-standalone-strict/resourceclaimconsumerreference-resource-v1beta2.json
@@ -0,0 +1,41 @@
+{
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimlist-resource-v1alpha3.json b/master-standalone-strict/resourceclaimlist-resource-v1alpha3.json
index 55e8e3a80c..e0bc0f17c7 100644
--- a/master-standalone-strict/resourceclaimlist-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaimlist-resource-v1alpha3.json
@@ -428,7 +428,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimlist-resource-v1beta1.json b/master-standalone-strict/resourceclaimlist-resource-v1beta1.json
index a782820c91..5a9eba8150 100644
--- a/master-standalone-strict/resourceclaimlist-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaimlist-resource-v1beta1.json
@@ -428,7 +428,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimlist-resource-v1beta2.json b/master-standalone-strict/resourceclaimlist-resource-v1beta2.json
new file mode 100644
index 0000000000..cd8948fcd0
--- /dev/null
+++ b/master-standalone-strict/resourceclaimlist-resource-v1beta2.json
@@ -0,0 +1,1273 @@
+{
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ },
+ "status": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimlist.json b/master-standalone-strict/resourceclaimlist.json
index d6c2cead3e..e92e8daaef 100644
--- a/master-standalone-strict/resourceclaimlist.json
+++ b/master-standalone-strict/resourceclaimlist.json
@@ -385,44 +385,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -551,97 +650,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -1068,7 +1078,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
@@ -1181,7 +1191,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
@@ -1249,7 +1259,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceclaimspec-resource-v1alpha3.json b/master-standalone-strict/resourceclaimspec-resource-v1alpha3.json
index 5da8f52d27..9eee3beace 100644
--- a/master-standalone-strict/resourceclaimspec-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaimspec-resource-v1alpha3.json
@@ -137,7 +137,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimspec-resource-v1beta1.json b/master-standalone-strict/resourceclaimspec-resource-v1beta1.json
index d3186a8996..f44b0e3d37 100644
--- a/master-standalone-strict/resourceclaimspec-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaimspec-resource-v1beta1.json
@@ -137,7 +137,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimspec-resource-v1beta2.json b/master-standalone-strict/resourceclaimspec-resource-v1beta2.json
new file mode 100644
index 0000000000..28f33d30d5
--- /dev/null
+++ b/master-standalone-strict/resourceclaimspec-resource-v1beta2.json
@@ -0,0 +1,398 @@
+{
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimspec.json b/master-standalone-strict/resourceclaimspec.json
index d3186a8996..28f33d30d5 100644
--- a/master-standalone-strict/resourceclaimspec.json
+++ b/master-standalone-strict/resourceclaimspec.json
@@ -100,44 +100,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -266,97 +365,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone-strict/resourceclaimstatus-resource-v1beta2.json b/master-standalone-strict/resourceclaimstatus-resource-v1beta2.json
new file mode 100644
index 0000000000..b949c93d83
--- /dev/null
+++ b/master-standalone-strict/resourceclaimstatus-resource-v1beta2.json
@@ -0,0 +1,497 @@
+{
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimstatus.json b/master-standalone-strict/resourceclaimstatus.json
index 37a05bcc2a..b949c93d83 100644
--- a/master-standalone-strict/resourceclaimstatus.json
+++ b/master-standalone-strict/resourceclaimstatus.json
@@ -396,7 +396,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone-strict/resourceclaimtemplate-resource-v1alpha3.json b/master-standalone-strict/resourceclaimtemplate-resource-v1alpha3.json
index 8588103f0f..b469dcd824 100644
--- a/master-standalone-strict/resourceclaimtemplate-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaimtemplate-resource-v1alpha3.json
@@ -669,7 +669,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplate-resource-v1beta1.json b/master-standalone-strict/resourceclaimtemplate-resource-v1beta1.json
index a0cc9abef0..08aff21ee4 100644
--- a/master-standalone-strict/resourceclaimtemplate-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaimtemplate-resource-v1beta1.json
@@ -669,7 +669,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplate-resource-v1beta2.json b/master-standalone-strict/resourceclaimtemplate-resource-v1beta2.json
new file mode 100644
index 0000000000..efb20f2bf4
--- /dev/null
+++ b/master-standalone-strict/resourceclaimtemplate-resource-v1beta2.json
@@ -0,0 +1,954 @@
+{
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimtemplate.json b/master-standalone-strict/resourceclaimtemplate.json
index 126c441bd1..e09f6d7c80 100644
--- a/master-standalone-strict/resourceclaimtemplate.json
+++ b/master-standalone-strict/resourceclaimtemplate.json
@@ -629,44 +629,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -795,97 +894,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -933,7 +943,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceclaimtemplatelist-resource-v1alpha3.json b/master-standalone-strict/resourceclaimtemplatelist-resource-v1alpha3.json
index 58fe4eba99..ce1929be19 100644
--- a/master-standalone-strict/resourceclaimtemplatelist-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaimtemplatelist-resource-v1alpha3.json
@@ -684,7 +684,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta1.json b/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta1.json
index b348d67028..647fd1069d 100644
--- a/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta1.json
@@ -684,7 +684,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta2.json b/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta2.json
new file mode 100644
index 0000000000..2781d08832
--- /dev/null
+++ b/master-standalone-strict/resourceclaimtemplatelist-resource-v1beta2.json
@@ -0,0 +1,1037 @@
+{
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": "object",
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimtemplatelist.json b/master-standalone-strict/resourceclaimtemplatelist.json
index 311bd2f338..c38a10a17b 100644
--- a/master-standalone-strict/resourceclaimtemplatelist.json
+++ b/master-standalone-strict/resourceclaimtemplatelist.json
@@ -641,44 +641,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -807,97 +906,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -945,7 +955,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
@@ -1013,7 +1023,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceclaimtemplatespec-resource-v1alpha3.json b/master-standalone-strict/resourceclaimtemplatespec-resource-v1alpha3.json
index 4ace10f8d4..fdcb6abe3c 100644
--- a/master-standalone-strict/resourceclaimtemplatespec-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceclaimtemplatespec-resource-v1alpha3.json
@@ -393,7 +393,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta1.json b/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta1.json
index 0e80b4a777..2a3c222a87 100644
--- a/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta1.json
+++ b/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta1.json
@@ -393,7 +393,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta2.json b/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta2.json
new file mode 100644
index 0000000000..6e1227f9e4
--- /dev/null
+++ b/master-standalone-strict/resourceclaimtemplatespec-resource-v1beta2.json
@@ -0,0 +1,664 @@
+{
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceclaimtemplatespec.json b/master-standalone-strict/resourceclaimtemplatespec.json
index 0e80b4a777..6e1227f9e4 100644
--- a/master-standalone-strict/resourceclaimtemplatespec.json
+++ b/master-standalone-strict/resourceclaimtemplatespec.json
@@ -356,44 +356,143 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
- ]
+ ],
+ "additionalProperties": false
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -522,97 +621,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone-strict/resourcepool-resource-v1beta2.json b/master-standalone-strict/resourcepool-resource-v1beta2.json
new file mode 100644
index 0000000000..2b21d88608
--- /dev/null
+++ b/master-standalone-strict/resourcepool-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceslice-resource-v1alpha3.json b/master-standalone-strict/resourceslice-resource-v1alpha3.json
index 5f8a965c5b..e96ad4b9ca 100644
--- a/master-standalone-strict/resourceslice-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceslice-resource-v1alpha3.json
@@ -368,11 +368,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -403,16 +407,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -553,7 +553,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -821,11 +821,11 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone-strict/resourceslice-resource-v1beta1.json b/master-standalone-strict/resourceslice-resource-v1beta1.json
index e7fe0a3b23..8433486877 100644
--- a/master-standalone-strict/resourceslice-resource-v1beta1.json
+++ b/master-standalone-strict/resourceslice-resource-v1beta1.json
@@ -381,11 +381,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -416,16 +420,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -566,7 +566,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/resourceslice-resource-v1beta2.json b/master-standalone-strict/resourceslice-resource-v1beta2.json
new file mode 100644
index 0000000000..5fea9892a8
--- /dev/null
+++ b/master-standalone-strict/resourceslice-resource-v1beta2.json
@@ -0,0 +1,876 @@
+{
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceslice.json b/master-standalone-strict/resourceslice.json
index 49dc455234..674f1a5792 100644
--- a/master-standalone-strict/resourceslice.json
+++ b/master-standalone-strict/resourceslice.json
@@ -286,126 +286,204 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
@@ -413,210 +491,122 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -797,7 +787,7 @@
"additionalProperties": false
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -831,7 +821,7 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -875,7 +865,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceslicelist-resource-v1alpha3.json b/master-standalone-strict/resourceslicelist-resource-v1alpha3.json
index a6c47de93b..8ef2e43f86 100644
--- a/master-standalone-strict/resourceslicelist-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceslicelist-resource-v1alpha3.json
@@ -383,11 +383,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -418,16 +422,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -568,7 +568,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -836,11 +836,11 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone-strict/resourceslicelist-resource-v1beta1.json b/master-standalone-strict/resourceslicelist-resource-v1beta1.json
index d382b5c9d5..3c452dd2bc 100644
--- a/master-standalone-strict/resourceslicelist-resource-v1beta1.json
+++ b/master-standalone-strict/resourceslicelist-resource-v1beta1.json
@@ -396,11 +396,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -431,16 +435,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -581,7 +581,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/resourceslicelist-resource-v1beta2.json b/master-standalone-strict/resourceslicelist-resource-v1beta2.json
new file mode 100644
index 0000000000..655223544f
--- /dev/null
+++ b/master-standalone-strict/resourceslicelist-resource-v1beta2.json
@@ -0,0 +1,959 @@
+{
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "spec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta2"
+ }
+ ],
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceslicelist.json b/master-standalone-strict/resourceslicelist.json
index 2bb52f3bb4..9ce1c20b78 100644
--- a/master-standalone-strict/resourceslicelist.json
+++ b/master-standalone-strict/resourceslicelist.json
@@ -298,126 +298,204 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
@@ -425,210 +503,122 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -809,7 +799,7 @@
"additionalProperties": false
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -843,7 +833,7 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -887,7 +877,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false
@@ -955,7 +945,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"additionalProperties": false,
diff --git a/master-standalone-strict/resourceslicespec-resource-v1alpha3.json b/master-standalone-strict/resourceslicespec-resource-v1alpha3.json
index 757fc56766..a2c721f91f 100644
--- a/master-standalone-strict/resourceslicespec-resource-v1alpha3.json
+++ b/master-standalone-strict/resourceslicespec-resource-v1alpha3.json
@@ -92,11 +92,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -127,16 +131,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -277,7 +277,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -551,11 +551,11 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone-strict/resourceslicespec-resource-v1beta1.json b/master-standalone-strict/resourceslicespec-resource-v1beta1.json
index ea6b896ab4..99b49691a9 100644
--- a/master-standalone-strict/resourceslicespec-resource-v1beta1.json
+++ b/master-standalone-strict/resourceslicespec-resource-v1beta1.json
@@ -105,11 +105,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -140,16 +144,12 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -290,7 +290,7 @@
"additionalProperties": false
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone-strict/resourceslicespec-resource-v1beta2.json b/master-standalone-strict/resourceslicespec-resource-v1beta2.json
new file mode 100644
index 0000000000..c23ea882ac
--- /dev/null
+++ b/master-standalone-strict/resourceslicespec-resource-v1beta2.json
@@ -0,0 +1,589 @@
+{
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic",
+ "additionalProperties": false
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "additionalProperties": false,
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone-strict/resourceslicespec.json b/master-standalone-strict/resourceslicespec.json
index ea6b896ab4..c23ea882ac 100644
--- a/master-standalone-strict/resourceslicespec.json
+++ b/master-standalone-strict/resourceslicespec.json
@@ -13,126 +13,204 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
@@ -140,210 +218,122 @@
],
"additionalProperties": false
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ],
- "additionalProperties": false
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
],
- "additionalProperties": false
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic",
- "additionalProperties": false
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
],
+ "x-kubernetes-map-type": "atomic",
"additionalProperties": false
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -530,7 +520,7 @@
"additionalProperties": false
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -564,7 +554,7 @@
],
"additionalProperties": false
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
diff --git a/master-standalone-strict/watchevent-meta-v1.json b/master-standalone-strict/watchevent-meta-v1.json
index f07dbd2021..9f204a698c 100644
--- a/master-standalone-strict/watchevent-meta-v1.json
+++ b/master-standalone-strict/watchevent-meta-v1.json
@@ -291,6 +291,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone-strict/watchevent.json b/master-standalone-strict/watchevent.json
index f07dbd2021..9f204a698c 100644
--- a/master-standalone-strict/watchevent.json
+++ b/master-standalone-strict/watchevent.json
@@ -291,6 +291,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone/_definitions.json b/master-standalone/_definitions.json
index 4b629a23e6..5c3d22900f 100644
--- a/master-standalone/_definitions.json
+++ b/master-standalone/_definitions.json
@@ -15396,8 +15396,8 @@
"description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
"type": "object"
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -15413,7 +15413,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
@@ -15456,11 +15456,11 @@
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
@@ -15731,20 +15731,20 @@
"io.k8s.api.resource.v1alpha3.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
@@ -15857,7 +15857,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -16553,55 +16553,1078 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.BasicDevice": {
- "description": "BasicDevice defines one device instance.",
+ "io.k8s.api.resource.v1beta1.BasicDevice": {
+ "description": "BasicDevice defines one device instance.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Counter": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CounterSet": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Device": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "basic": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
+ "description": "Basic defines one device instance."
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": "boolean"
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": "string"
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": "string"
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequest": {
+ "description": "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.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "firstAvailable": {
+ "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": "string"
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": "string"
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": "string"
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "pool": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocatedDeviceStatus": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocationResult": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
"properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "boolean"
- },
- "attributes": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "capacity": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
- },
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "string"
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
},
"nodeSelector": {
"$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "io.k8s.api.resource.v1beta2.CELDeviceSelector": {
"description": "CELDeviceSelector contains a CEL expression for selecting a device.",
"properties": {
"expression": {
@@ -16614,7 +17637,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Counter": {
+ "io.k8s.api.resource.v1beta2.Counter": {
"description": "Counter describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16627,14 +17650,14 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CounterSet": {
+ "io.k8s.api.resource.v1beta2.CounterSet": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -16648,16 +17671,54 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Device": {
+ "io.k8s.api.resource.v1beta2.Device": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
"type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16665,11 +17726,11 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration": {
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16690,13 +17751,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationResult": {
"description": "DeviceAllocationResult is the result of allocating devices.",
"properties": {
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16704,7 +17765,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16712,7 +17773,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "io.k8s.api.resource.v1beta2.DeviceAttribute": {
"description": "DeviceAttribute must have exactly one field set.",
"properties": {
"bool": {
@@ -16735,7 +17796,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "io.k8s.api.resource.v1beta2.DeviceCapacity": {
"description": "DeviceCapacity describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16748,13 +17809,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "io.k8s.api.resource.v1beta2.DeviceClaim": {
"description": "DeviceClaim defines how to request devices with a ResourceClaim.",
"properties": {
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16762,7 +17823,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16770,7 +17831,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16778,11 +17839,11 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClaimConfiguration": {
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16796,7 +17857,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "io.k8s.api.resource.v1beta2.DeviceClass": {
"description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -16815,7 +17876,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -16827,21 +17888,21 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClassConfiguration": {
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "io.k8s.api.resource.v1beta2.DeviceClassList": {
"description": "DeviceClassList is a collection of classes.",
"properties": {
"apiVersion": {
@@ -16851,7 +17912,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": "array"
},
@@ -16875,17 +17936,17 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "io.k8s.api.resource.v1beta2.DeviceClassSpec": {
"description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
"properties": {
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16893,7 +17954,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16901,7 +17962,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "io.k8s.api.resource.v1beta2.DeviceConstraint": {
"description": "DeviceConstraint must have exactly one field set besides Requests.",
"properties": {
"matchAttribute": {
@@ -16919,74 +17980,45 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "io.k8s.api.resource.v1beta2.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequest": {
- "description": "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.",
+ "io.k8s.api.resource.v1beta2.DeviceRequest": {
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": "boolean"
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": "string"
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": "integer"
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": "string"
+ "exactly": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16994,7 +18026,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult": {
"description": "DeviceRequestAllocationResult contains the allocation result for one request.",
"properties": {
"adminAccess": {
@@ -17020,7 +18052,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17034,21 +18066,21 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "io.k8s.api.resource.v1beta2.DeviceSelector": {
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "io.k8s.api.resource.v1beta2.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -17067,7 +18099,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17075,7 +18107,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17087,7 +18119,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "io.k8s.api.resource.v1beta2.DeviceTaint": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
"effect": {
@@ -17113,7 +18145,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "io.k8s.api.resource.v1beta2.DeviceToleration": {
"description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
"properties": {
"effect": {
@@ -17140,7 +18172,49 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "io.k8s.api.resource.v1beta2.ExactDeviceRequest": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.NetworkDeviceData": {
"description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
"properties": {
"hardwareAddress": {
@@ -17152,7 +18226,7 @@
"type": "string"
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": "string"
},
@@ -17162,7 +18236,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration": {
"description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
"properties": {
"driver": {
@@ -17180,7 +18254,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "io.k8s.api.resource.v1beta2.ResourceClaim": {
"description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17199,11 +18273,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -17215,11 +18289,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference": {
"description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
"properties": {
"apiGroup": {
@@ -17246,7 +18320,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimList": {
"description": "ResourceClaimList is a collection of claims.",
"properties": {
"apiVersion": {
@@ -17256,7 +18330,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": "array"
},
@@ -17280,31 +18354,31 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimSpec": {
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimStatus": {
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17317,7 +18391,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17330,7 +18404,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplate": {
"description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17349,7 +18423,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -17361,11 +18435,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateList": {
"description": "ResourceClaimTemplateList is a collection of claim templates.",
"properties": {
"apiVersion": {
@@ -17375,7 +18449,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": "array"
},
@@ -17399,11 +18473,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec": {
"description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
"properties": {
"metadata": {
@@ -17411,7 +18485,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
@@ -17420,7 +18494,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "io.k8s.api.resource.v1beta2.ResourcePool": {
"description": "ResourcePool describes the pool that ResourceSlices belong to.",
"properties": {
"generation": {
@@ -17445,7 +18519,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "io.k8s.api.resource.v1beta2.ResourceSlice": {
"description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17464,7 +18538,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -17476,11 +18550,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceList": {
"description": "ResourceSliceList is a collection of ResourceSlices.",
"properties": {
"apiVersion": {
@@ -17490,7 +18564,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": "array"
},
@@ -17514,11 +18588,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceSpec": {
"description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
"properties": {
"allNodes": {
@@ -17528,7 +18602,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17550,13 +18624,13 @@
"type": "boolean"
},
"pool": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -19927,6 +21001,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
@@ -20682,6 +21761,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone/all.json b/master-standalone/all.json
index 3e0bb04b13..91d92e58e3 100644
--- a/master-standalone/all.json
+++ b/master-standalone/all.json
@@ -1734,6 +1734,123 @@
{
"$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec"
},
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceList"
+ },
+ {
+ "$ref": "_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec"
+ },
{
"$ref": "_definitions.json#/definitions/io.k8s.api.scheduling.v1.PriorityClass"
},
diff --git a/master-standalone/allocateddevicestatus-resource-v1beta2.json b/master-standalone/allocateddevicestatus-resource-v1beta2.json
new file mode 100644
index 0000000000..20400048bc
--- /dev/null
+++ b/master-standalone/allocateddevicestatus-resource-v1beta2.json
@@ -0,0 +1,133 @@
+{
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/allocateddevicestatus.json b/master-standalone/allocateddevicestatus.json
index e7475e084a..20400048bc 100644
--- a/master-standalone/allocateddevicestatus.json
+++ b/master-standalone/allocateddevicestatus.json
@@ -96,7 +96,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone/allocationresult-resource-v1beta2.json b/master-standalone/allocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..46b3ffd768
--- /dev/null
+++ b/master-standalone/allocationresult-resource-v1beta2.json
@@ -0,0 +1,288 @@
+{
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/basicdevice-resource-v1alpha3.json b/master-standalone/basicdevice-resource-v1alpha3.json
index fee73f4ffa..ff7ee85a58 100644
--- a/master-standalone/basicdevice-resource-v1alpha3.json
+++ b/master-standalone/basicdevice-resource-v1alpha3.json
@@ -76,11 +76,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -110,16 +114,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -255,7 +255,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/basicdevice-resource-v1beta1.json b/master-standalone/basicdevice-resource-v1beta1.json
index efe6104e8e..499f978dda 100644
--- a/master-standalone/basicdevice-resource-v1beta1.json
+++ b/master-standalone/basicdevice-resource-v1beta1.json
@@ -88,11 +88,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -122,16 +126,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -267,7 +267,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/basicdevice.json b/master-standalone/basicdevice.json
index efe6104e8e..499f978dda 100644
--- a/master-standalone/basicdevice.json
+++ b/master-standalone/basicdevice.json
@@ -88,11 +88,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -122,16 +126,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -267,7 +267,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/celdeviceselector-resource-v1beta2.json b/master-standalone/celdeviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..b63da15344
--- /dev/null
+++ b/master-standalone/celdeviceselector-resource-v1beta2.json
@@ -0,0 +1,17 @@
+{
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/counter-resource-v1beta2.json b/master-standalone/counter-resource-v1beta2.json
new file mode 100644
index 0000000000..968d9214b3
--- /dev/null
+++ b/master-standalone/counter-resource-v1beta2.json
@@ -0,0 +1,26 @@
+{
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/counterset-resource-v1alpha3.json b/master-standalone/counterset-resource-v1alpha3.json
index 6c81cc5151..ff0c5ecf13 100644
--- a/master-standalone/counterset-resource-v1alpha3.json
+++ b/master-standalone/counterset-resource-v1alpha3.json
@@ -30,14 +30,14 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": [
"object",
"null"
]
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
"string",
"null"
diff --git a/master-standalone/counterset-resource-v1beta2.json b/master-standalone/counterset-resource-v1beta2.json
new file mode 100644
index 0000000000..d285c45b26
--- /dev/null
+++ b/master-standalone/counterset-resource-v1beta2.json
@@ -0,0 +1,53 @@
+{
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/counterset.json b/master-standalone/counterset.json
index b1f4276cfd..d285c45b26 100644
--- a/master-standalone/counterset.json
+++ b/master-standalone/counterset.json
@@ -30,7 +30,7 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": [
"object",
"null"
diff --git a/master-standalone/deleteoptions-meta-v1.json b/master-standalone/deleteoptions-meta-v1.json
index 20ecc9d9f2..5c236cc0c8 100644
--- a/master-standalone/deleteoptions-meta-v1.json
+++ b/master-standalone/deleteoptions-meta-v1.json
@@ -62,6 +62,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -420,6 +421,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone/deleteoptions.json b/master-standalone/deleteoptions.json
index 3d28c49da3..88ad121be1 100644
--- a/master-standalone/deleteoptions.json
+++ b/master-standalone/deleteoptions.json
@@ -357,6 +357,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone/device-resource-v1alpha3.json b/master-standalone/device-resource-v1alpha3.json
index ea391eaa4a..457ceea184 100644
--- a/master-standalone/device-resource-v1alpha3.json
+++ b/master-standalone/device-resource-v1alpha3.json
@@ -79,11 +79,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -113,16 +117,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -258,7 +258,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/device-resource-v1beta1.json b/master-standalone/device-resource-v1beta1.json
index 6240ec3edd..052dea49a6 100644
--- a/master-standalone/device-resource-v1beta1.json
+++ b/master-standalone/device-resource-v1beta1.json
@@ -91,11 +91,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -125,16 +129,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -270,7 +270,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/device-resource-v1beta2.json b/master-standalone/device-resource-v1beta2.json
new file mode 100644
index 0000000000..f48b11f8f9
--- /dev/null
+++ b/master-standalone/device-resource-v1beta2.json
@@ -0,0 +1,326 @@
+{
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/device.json b/master-standalone/device.json
index 6240ec3edd..f48b11f8f9 100644
--- a/master-standalone/device.json
+++ b/master-standalone/device.json
@@ -1,330 +1,321 @@
{
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
]
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ]
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ]
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic"
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
"type": [
- "string",
+ "array",
"null"
- ]
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone/deviceallocationconfiguration-resource-v1beta2.json b/master-standalone/deviceallocationconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..1c83bbf1d0
--- /dev/null
+++ b/master-standalone/deviceallocationconfiguration-resource-v1beta2.json
@@ -0,0 +1,52 @@
+{
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceallocationresult-resource-v1beta2.json b/master-standalone/deviceallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..25927e8f79
--- /dev/null
+++ b/master-standalone/deviceallocationresult-resource-v1beta2.json
@@ -0,0 +1,165 @@
+{
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceattribute-resource-v1beta2.json b/master-standalone/deviceattribute-resource-v1beta2.json
new file mode 100644
index 0000000000..4ad000a165
--- /dev/null
+++ b/master-standalone/deviceattribute-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicecapacity-resource-v1beta2.json b/master-standalone/devicecapacity-resource-v1beta2.json
new file mode 100644
index 0000000000..7116bad235
--- /dev/null
+++ b/master-standalone/devicecapacity-resource-v1beta2.json
@@ -0,0 +1,26 @@
+{
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclaim-resource-v1alpha3.json b/master-standalone/deviceclaim-resource-v1alpha3.json
index 192c646032..3bfba7d840 100644
--- a/master-standalone/deviceclaim-resource-v1alpha3.json
+++ b/master-standalone/deviceclaim-resource-v1alpha3.json
@@ -131,7 +131,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/deviceclaim-resource-v1beta1.json b/master-standalone/deviceclaim-resource-v1beta1.json
index 5c94c95334..5e212c3ef1 100644
--- a/master-standalone/deviceclaim-resource-v1beta1.json
+++ b/master-standalone/deviceclaim-resource-v1beta1.json
@@ -131,7 +131,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/deviceclaim-resource-v1beta2.json b/master-standalone/deviceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..2910c7cea1
--- /dev/null
+++ b/master-standalone/deviceclaim-resource-v1beta2.json
@@ -0,0 +1,375 @@
+{
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclaim.json b/master-standalone/deviceclaim.json
index 5c94c95334..2910c7cea1 100644
--- a/master-standalone/deviceclaim.json
+++ b/master-standalone/deviceclaim.json
@@ -94,44 +94,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -256,94 +351,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone/deviceclaimconfiguration-resource-v1beta2.json b/master-standalone/deviceclaimconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..e0fa07886d
--- /dev/null
+++ b/master-standalone/deviceclaimconfiguration-resource-v1beta2.json
@@ -0,0 +1,42 @@
+{
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclass-resource-v1beta2.json b/master-standalone/deviceclass-resource-v1beta2.json
new file mode 100644
index 0000000000..24a40129c3
--- /dev/null
+++ b/master-standalone/deviceclass-resource-v1beta2.json
@@ -0,0 +1,367 @@
+{
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclass.json b/master-standalone/deviceclass.json
index 744c601864..2176e08545 100644
--- a/master-standalone/deviceclass.json
+++ b/master-standalone/deviceclass.json
@@ -357,7 +357,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/deviceclassconfiguration-resource-v1beta2.json b/master-standalone/deviceclassconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..144857aaad
--- /dev/null
+++ b/master-standalone/deviceclassconfiguration-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclasslist-resource-v1beta2.json b/master-standalone/deviceclasslist-resource-v1beta2.json
new file mode 100644
index 0000000000..ece249257a
--- /dev/null
+++ b/master-standalone/deviceclasslist-resource-v1beta2.json
@@ -0,0 +1,448 @@
+{
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceclasslist.json b/master-standalone/deviceclasslist.json
index d0d7302b94..1aa3caaec7 100644
--- a/master-standalone/deviceclasslist.json
+++ b/master-standalone/deviceclasslist.json
@@ -369,7 +369,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
@@ -435,7 +435,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/deviceclassspec-resource-v1beta2.json b/master-standalone/deviceclassspec-resource-v1beta2.json
new file mode 100644
index 0000000000..02f531dec7
--- /dev/null
+++ b/master-standalone/deviceclassspec-resource-v1beta2.json
@@ -0,0 +1,78 @@
+{
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceconstraint-resource-v1beta2.json b/master-standalone/deviceconstraint-resource-v1beta2.json
new file mode 100644
index 0000000000..9603a6111e
--- /dev/null
+++ b/master-standalone/deviceconstraint-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicecounterconsumption-resource-v1alpha3.json b/master-standalone/devicecounterconsumption-resource-v1alpha3.json
index 4ff3cd2bd8..1c625ab3d5 100644
--- a/master-standalone/devicecounterconsumption-resource-v1alpha3.json
+++ b/master-standalone/devicecounterconsumption-resource-v1alpha3.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -30,22 +37,15 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone/devicecounterconsumption-resource-v1beta1.json b/master-standalone/devicecounterconsumption-resource-v1beta1.json
index 4ff3cd2bd8..1c9f027182 100644
--- a/master-standalone/devicecounterconsumption-resource-v1beta1.json
+++ b/master-standalone/devicecounterconsumption-resource-v1beta1.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -30,22 +37,15 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone/devicecounterconsumption-resource-v1beta2.json b/master-standalone/devicecounterconsumption-resource-v1beta2.json
new file mode 100644
index 0000000000..1c9f027182
--- /dev/null
+++ b/master-standalone/devicecounterconsumption-resource-v1beta2.json
@@ -0,0 +1,53 @@
+{
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicecounterconsumption.json b/master-standalone/devicecounterconsumption.json
index 4ff3cd2bd8..1c9f027182 100644
--- a/master-standalone/devicecounterconsumption.json
+++ b/master-standalone/devicecounterconsumption.json
@@ -1,6 +1,13 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -30,22 +37,15 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master-standalone/devicerequest-resource-v1alpha3.json b/master-standalone/devicerequest-resource-v1alpha3.json
index 6bbf0a39c2..38a2d9e63f 100644
--- a/master-standalone/devicerequest-resource-v1alpha3.json
+++ b/master-standalone/devicerequest-resource-v1alpha3.json
@@ -36,7 +36,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/devicerequest-resource-v1beta1.json b/master-standalone/devicerequest-resource-v1beta1.json
index f40396cb16..97dcd2ed8a 100644
--- a/master-standalone/devicerequest-resource-v1beta1.json
+++ b/master-standalone/devicerequest-resource-v1beta1.json
@@ -36,7 +36,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/devicerequest-resource-v1beta2.json b/master-standalone/devicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..b9293e82c1
--- /dev/null
+++ b/master-standalone/devicerequest-resource-v1beta2.json
@@ -0,0 +1,271 @@
+{
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicerequest.json b/master-standalone/devicerequest.json
index f40396cb16..b9293e82c1 100644
--- a/master-standalone/devicerequest.json
+++ b/master-standalone/devicerequest.json
@@ -1,42 +1,137 @@
{
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -161,97 +256,11 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": [
"string",
"null"
]
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone/devicerequestallocationresult-resource-v1beta2.json b/master-standalone/devicerequestallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..f12f72ca87
--- /dev/null
+++ b/master-standalone/devicerequestallocationresult-resource-v1beta2.json
@@ -0,0 +1,101 @@
+{
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/deviceselector-resource-v1beta2.json b/master-standalone/deviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..967ca06538
--- /dev/null
+++ b/master-standalone/deviceselector-resource-v1beta2.json
@@ -0,0 +1,23 @@
+{
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicesubrequest-resource-v1alpha3.json b/master-standalone/devicesubrequest-resource-v1alpha3.json
index 9bfd918140..82f1ea0ed8 100644
--- a/master-standalone/devicesubrequest-resource-v1alpha3.json
+++ b/master-standalone/devicesubrequest-resource-v1alpha3.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/devicesubrequest-resource-v1beta1.json b/master-standalone/devicesubrequest-resource-v1beta1.json
index a38aaa167c..3aff0f8a4e 100644
--- a/master-standalone/devicesubrequest-resource-v1beta1.json
+++ b/master-standalone/devicesubrequest-resource-v1beta1.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/devicesubrequest-resource-v1beta2.json b/master-standalone/devicesubrequest-resource-v1beta2.json
new file mode 100644
index 0000000000..317cc0e81c
--- /dev/null
+++ b/master-standalone/devicesubrequest-resource-v1beta2.json
@@ -0,0 +1,126 @@
+{
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicesubrequest.json b/master-standalone/devicesubrequest.json
index a38aaa167c..317cc0e81c 100644
--- a/master-standalone/devicesubrequest.json
+++ b/master-standalone/devicesubrequest.json
@@ -1,8 +1,8 @@
{
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/devicetaint-resource-v1beta2.json b/master-standalone/devicetaint-resource-v1beta2.json
new file mode 100644
index 0000000000..da873523ef
--- /dev/null
+++ b/master-standalone/devicetaint-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/devicetoleration-resource-v1beta2.json b/master-standalone/devicetoleration-resource-v1beta2.json
new file mode 100644
index 0000000000..8fb10b765d
--- /dev/null
+++ b/master-standalone/devicetoleration-resource-v1beta2.json
@@ -0,0 +1,43 @@
+{
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/eviction-policy-v1.json b/master-standalone/eviction-policy-v1.json
index 05f6be5967..cf854773a9 100644
--- a/master-standalone/eviction-policy-v1.json
+++ b/master-standalone/eviction-policy-v1.json
@@ -75,6 +75,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -436,6 +437,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone/eviction.json b/master-standalone/eviction.json
index 5f2f8f92e6..1129f9842e 100644
--- a/master-standalone/eviction.json
+++ b/master-standalone/eviction.json
@@ -370,6 +370,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master-standalone/exactdevicerequest-resource-v1beta2.json b/master-standalone/exactdevicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..620eef49cf
--- /dev/null
+++ b/master-standalone/exactdevicerequest-resource-v1beta2.json
@@ -0,0 +1,125 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/exactdevicerequest.json b/master-standalone/exactdevicerequest.json
new file mode 100644
index 0000000000..620eef49cf
--- /dev/null
+++ b/master-standalone/exactdevicerequest.json
@@ -0,0 +1,125 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/networkdevicedata-resource-v1beta2.json b/master-standalone/networkdevicedata-resource-v1beta2.json
new file mode 100644
index 0000000000..b291f267e3
--- /dev/null
+++ b/master-standalone/networkdevicedata-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/networkdevicedata.json b/master-standalone/networkdevicedata.json
index ea6cc68bbd..b291f267e3 100644
--- a/master-standalone/networkdevicedata.json
+++ b/master-standalone/networkdevicedata.json
@@ -16,7 +16,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone/opaquedeviceconfiguration-resource-v1beta2.json b/master-standalone/opaquedeviceconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..706dd6db94
--- /dev/null
+++ b/master-standalone/opaquedeviceconfiguration-resource-v1beta2.json
@@ -0,0 +1,25 @@
+{
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaim-resource-v1alpha3.json b/master-standalone/resourceclaim-resource-v1alpha3.json
index b198f0e2f3..737cced37e 100644
--- a/master-standalone/resourceclaim-resource-v1alpha3.json
+++ b/master-standalone/resourceclaim-resource-v1alpha3.json
@@ -407,7 +407,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaim-resource-v1beta1.json b/master-standalone/resourceclaim-resource-v1beta1.json
index c68768e3b3..401ccc1edd 100644
--- a/master-standalone/resourceclaim-resource-v1beta1.json
+++ b/master-standalone/resourceclaim-resource-v1beta1.json
@@ -407,7 +407,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaim-resource-v1beta2.json b/master-standalone/resourceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..03be7a5cba
--- /dev/null
+++ b/master-standalone/resourceclaim-resource-v1beta2.json
@@ -0,0 +1,1157 @@
+{
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaim.json b/master-standalone/resourceclaim.json
index 08b4bdcb1c..05e637eb00 100644
--- a/master-standalone/resourceclaim.json
+++ b/master-standalone/resourceclaim.json
@@ -367,44 +367,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -529,94 +624,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -1032,7 +1041,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
@@ -1138,7 +1147,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceclaimconsumerreference-resource-v1beta2.json b/master-standalone/resourceclaimconsumerreference-resource-v1beta2.json
new file mode 100644
index 0000000000..c7b403264b
--- /dev/null
+++ b/master-standalone/resourceclaimconsumerreference-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimlist-resource-v1alpha3.json b/master-standalone/resourceclaimlist-resource-v1alpha3.json
index 204c1ffe7f..a68e1438dd 100644
--- a/master-standalone/resourceclaimlist-resource-v1alpha3.json
+++ b/master-standalone/resourceclaimlist-resource-v1alpha3.json
@@ -422,7 +422,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimlist-resource-v1beta1.json b/master-standalone/resourceclaimlist-resource-v1beta1.json
index b24f47d9b9..38b9aa5cbd 100644
--- a/master-standalone/resourceclaimlist-resource-v1beta1.json
+++ b/master-standalone/resourceclaimlist-resource-v1beta1.json
@@ -422,7 +422,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimlist-resource-v1beta2.json b/master-standalone/resourceclaimlist-resource-v1beta2.json
new file mode 100644
index 0000000000..57b44bc433
--- /dev/null
+++ b/master-standalone/resourceclaimlist-resource-v1beta2.json
@@ -0,0 +1,1238 @@
+{
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "status": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimlist.json b/master-standalone/resourceclaimlist.json
index 369ee85667..01e2299400 100644
--- a/master-standalone/resourceclaimlist.json
+++ b/master-standalone/resourceclaimlist.json
@@ -379,44 +379,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -541,94 +636,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -1041,7 +1050,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
@@ -1150,7 +1159,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
@@ -1216,7 +1225,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceclaimspec-resource-v1alpha3.json b/master-standalone/resourceclaimspec-resource-v1alpha3.json
index 4652994532..fa1b6f55f7 100644
--- a/master-standalone/resourceclaimspec-resource-v1alpha3.json
+++ b/master-standalone/resourceclaimspec-resource-v1alpha3.json
@@ -134,7 +134,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimspec-resource-v1beta1.json b/master-standalone/resourceclaimspec-resource-v1beta1.json
index 85a9904a0c..a7a2b3e4a3 100644
--- a/master-standalone/resourceclaimspec-resource-v1beta1.json
+++ b/master-standalone/resourceclaimspec-resource-v1beta1.json
@@ -134,7 +134,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimspec-resource-v1beta2.json b/master-standalone/resourceclaimspec-resource-v1beta2.json
new file mode 100644
index 0000000000..cbc686942b
--- /dev/null
+++ b/master-standalone/resourceclaimspec-resource-v1beta2.json
@@ -0,0 +1,384 @@
+{
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimspec.json b/master-standalone/resourceclaimspec.json
index 85a9904a0c..cbc686942b 100644
--- a/master-standalone/resourceclaimspec.json
+++ b/master-standalone/resourceclaimspec.json
@@ -97,44 +97,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -259,94 +354,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone/resourceclaimstatus-resource-v1beta2.json b/master-standalone/resourceclaimstatus-resource-v1beta2.json
new file mode 100644
index 0000000000..8cd7a6a5b2
--- /dev/null
+++ b/master-standalone/resourceclaimstatus-resource-v1beta2.json
@@ -0,0 +1,482 @@
+{
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "description": "Condition contains details for one aspect of the current state of this API Resource.",
+ "properties": {
+ "lastTransitionTime": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "message": {
+ "description": "message is a human readable message indicating details about the transition. This may be an empty string.",
+ "type": "string"
+ },
+ "observedGeneration": {
+ "description": "observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.",
+ "type": "string"
+ },
+ "status": {
+ "description": "status of the condition, one of True, False, Unknown.",
+ "type": "string"
+ },
+ "type": {
+ "description": "type of condition in CamelCase or in foo.example.com/CamelCase.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "status",
+ "lastTransitionTime",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimstatus.json b/master-standalone/resourceclaimstatus.json
index d3255eb57b..8cd7a6a5b2 100644
--- a/master-standalone/resourceclaimstatus.json
+++ b/master-standalone/resourceclaimstatus.json
@@ -385,7 +385,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master-standalone/resourceclaimtemplate-resource-v1alpha3.json b/master-standalone/resourceclaimtemplate-resource-v1alpha3.json
index 15e7d967a3..9c6d553734 100644
--- a/master-standalone/resourceclaimtemplate-resource-v1alpha3.json
+++ b/master-standalone/resourceclaimtemplate-resource-v1alpha3.json
@@ -660,7 +660,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplate-resource-v1beta1.json b/master-standalone/resourceclaimtemplate-resource-v1beta1.json
index 958090f122..beb5fb1469 100644
--- a/master-standalone/resourceclaimtemplate-resource-v1beta1.json
+++ b/master-standalone/resourceclaimtemplate-resource-v1beta1.json
@@ -660,7 +660,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplate-resource-v1beta2.json b/master-standalone/resourceclaimtemplate-resource-v1beta2.json
new file mode 100644
index 0000000000..fb4a0b5481
--- /dev/null
+++ b/master-standalone/resourceclaimtemplate-resource-v1beta2.json
@@ -0,0 +1,932 @@
+{
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimtemplate.json b/master-standalone/resourceclaimtemplate.json
index cbc64f4369..baf1fc5e8a 100644
--- a/master-standalone/resourceclaimtemplate.json
+++ b/master-standalone/resourceclaimtemplate.json
@@ -620,44 +620,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -782,94 +877,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -913,7 +922,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceclaimtemplatelist-resource-v1alpha3.json b/master-standalone/resourceclaimtemplatelist-resource-v1alpha3.json
index d5d8b6819a..131a219439 100644
--- a/master-standalone/resourceclaimtemplatelist-resource-v1alpha3.json
+++ b/master-standalone/resourceclaimtemplatelist-resource-v1alpha3.json
@@ -675,7 +675,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplatelist-resource-v1beta1.json b/master-standalone/resourceclaimtemplatelist-resource-v1beta1.json
index 9022df61f6..f919e64058 100644
--- a/master-standalone/resourceclaimtemplatelist-resource-v1beta1.json
+++ b/master-standalone/resourceclaimtemplatelist-resource-v1beta1.json
@@ -675,7 +675,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplatelist-resource-v1beta2.json b/master-standalone/resourceclaimtemplatelist-resource-v1beta2.json
new file mode 100644
index 0000000000..ecc2673b2b
--- /dev/null
+++ b/master-standalone/resourceclaimtemplatelist-resource-v1beta2.json
@@ -0,0 +1,1013 @@
+{
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimtemplatelist.json b/master-standalone/resourceclaimtemplatelist.json
index 24cc097809..c9948b0d81 100644
--- a/master-standalone/resourceclaimtemplatelist.json
+++ b/master-standalone/resourceclaimtemplatelist.json
@@ -632,44 +632,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -794,94 +889,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -925,7 +934,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
@@ -991,7 +1000,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceclaimtemplatespec-resource-v1alpha3.json b/master-standalone/resourceclaimtemplatespec-resource-v1alpha3.json
index f78e611323..753fe21280 100644
--- a/master-standalone/resourceclaimtemplatespec-resource-v1alpha3.json
+++ b/master-standalone/resourceclaimtemplatespec-resource-v1alpha3.json
@@ -387,7 +387,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplatespec-resource-v1beta1.json b/master-standalone/resourceclaimtemplatespec-resource-v1beta1.json
index bc6aff9ccd..8f29bce290 100644
--- a/master-standalone/resourceclaimtemplatespec-resource-v1beta1.json
+++ b/master-standalone/resourceclaimtemplatespec-resource-v1beta1.json
@@ -387,7 +387,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master-standalone/resourceclaimtemplatespec-resource-v1beta2.json b/master-standalone/resourceclaimtemplatespec-resource-v1beta2.json
new file mode 100644
index 0000000000..f594d3c350
--- /dev/null
+++ b/master-standalone/resourceclaimtemplatespec-resource-v1beta2.json
@@ -0,0 +1,646 @@
+{
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "description": "RawExtension is used to hold extensions in external versions.\n\nTo use this, make a field which has RawExtension as its type in your external, versioned struct, and Object in your internal struct. You also need to register your various plugin types.\n\n// Internal package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.Object `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// External package:\n\n\ttype MyAPIObject struct {\n\t\truntime.TypeMeta `json:\",inline\"`\n\t\tMyPlugin runtime.RawExtension `json:\"myPlugin\"`\n\t}\n\n\ttype PluginA struct {\n\t\tAOption string `json:\"aOption\"`\n\t}\n\n// On the wire, the JSON will look something like this:\n\n\t{\n\t\t\"kind\":\"MyAPIObject\",\n\t\t\"apiVersion\":\"v1\",\n\t\t\"myPlugin\": {\n\t\t\t\"kind\":\"PluginA\",\n\t\t\t\"aOption\":\"foo\",\n\t\t},\n\t}\n\nSo what happens? Decode first uses json or yaml to unmarshal the serialized data into your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked. The next step is to copy (using pkg/conversion) into the internal struct. The runtime package's DefaultScheme has conversion functions installed which will unpack the JSON stored in RawExtension, turning it into the correct object type, and storing it in the Object. (TODO: In the case where the object is of an unknown type, a runtime.Unknown object will be created and stored.)",
+ "type": "object"
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceclaimtemplatespec.json b/master-standalone/resourceclaimtemplatespec.json
index bc6aff9ccd..f594d3c350 100644
--- a/master-standalone/resourceclaimtemplatespec.json
+++ b/master-standalone/resourceclaimtemplatespec.json
@@ -350,44 +350,139 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "exactly": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
"type": [
- "string",
+ "object",
"null"
]
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -512,94 +607,8 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "description": "DeviceSelector must have exactly one field set.",
- "properties": {
- "cel": {
- "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
- "properties": {
- "expression": {
- "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
- "type": "string"
- }
- },
- "required": [
- "expression"
- ],
- "type": [
- "object",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
- "properties": {
- "effect": {
- "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
- "type": [
- "string",
- "null"
- ]
- },
- "key": {
- "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
- "type": [
- "string",
- "null"
- ]
- },
- "operator": {
- "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
- "type": [
- "string",
- "null"
- ]
- },
- "tolerationSeconds": {
- "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "value": {
- "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master-standalone/resourcepool-resource-v1beta2.json b/master-standalone/resourcepool-resource-v1beta2.json
new file mode 100644
index 0000000000..c85bd4c5ed
--- /dev/null
+++ b/master-standalone/resourcepool-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceslice-resource-v1alpha3.json b/master-standalone/resourceslice-resource-v1alpha3.json
index 595755fdf2..2b8062adb8 100644
--- a/master-standalone/resourceslice-resource-v1alpha3.json
+++ b/master-standalone/resourceslice-resource-v1alpha3.json
@@ -364,11 +364,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -398,16 +402,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -543,7 +543,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -802,11 +802,11 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone/resourceslice-resource-v1beta1.json b/master-standalone/resourceslice-resource-v1beta1.json
index e628bdd618..43308e765a 100644
--- a/master-standalone/resourceslice-resource-v1beta1.json
+++ b/master-standalone/resourceslice-resource-v1beta1.json
@@ -376,11 +376,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -410,16 +414,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -555,7 +555,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/resourceslice-resource-v1beta2.json b/master-standalone/resourceslice-resource-v1beta2.json
new file mode 100644
index 0000000000..459d5a658d
--- /dev/null
+++ b/master-standalone/resourceslice-resource-v1beta2.json
@@ -0,0 +1,854 @@
+{
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object"
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceslice.json b/master-standalone/resourceslice.json
index bc9f4d259c..90d4ee61d7 100644
--- a/master-standalone/resourceslice.json
+++ b/master-standalone/resourceslice.json
@@ -283,327 +283,318 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
]
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ]
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ]
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic"
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -778,7 +769,7 @@
"type": "object"
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -811,7 +802,7 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -853,7 +844,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceslicelist-resource-v1alpha3.json b/master-standalone/resourceslicelist-resource-v1alpha3.json
index 81b0780e73..20fb2c1c17 100644
--- a/master-standalone/resourceslicelist-resource-v1alpha3.json
+++ b/master-standalone/resourceslicelist-resource-v1alpha3.json
@@ -379,11 +379,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -413,16 +417,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -558,7 +558,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -817,11 +817,11 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone/resourceslicelist-resource-v1beta1.json b/master-standalone/resourceslicelist-resource-v1beta1.json
index 9de17d82ff..8cfdf3e97a 100644
--- a/master-standalone/resourceslicelist-resource-v1beta1.json
+++ b/master-standalone/resourceslicelist-resource-v1beta1.json
@@ -391,11 +391,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -425,16 +429,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -570,7 +570,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/resourceslicelist-resource-v1beta2.json b/master-standalone/resourceslicelist-resource-v1beta2.json
new file mode 100644
index 0000000000..2ec481bba8
--- /dev/null
+++ b/master-standalone/resourceslicelist-resource-v1beta2.json
@@ -0,0 +1,935 @@
+{
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "description": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
+ "properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "creationTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "deletionGracePeriodSeconds": {
+ "description": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deletionTimestamp": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "finalizers": {
+ "description": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "set",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "generateName": {
+ "description": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will return a 409.\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "generation": {
+ "description": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "managedFields": {
+ "description": "ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like \"ci-cd\". The set of fields is always in the version that the workflow used when modifying the object.",
+ "items": {
+ "description": "ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the version of this resource that this field set applies to. The format is \"group/version\" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsType": {
+ "description": "FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: \"FieldsV1\"",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "fieldsV1": {
+ "description": "FieldsV1 stores a set of fields in a data structure like a Trie, in JSON format.\n\nEach key is either a '.' representing the field itself, and will always map to an empty set, or a string representing a sub-field or item. The string will follow one of these four formats: 'f:<name>', where <name> is the name of a field in a struct, or key in a map 'v:<value>', where <value> is the exact json formatted value of a list item 'i:<index>', where <index> is position of a item in a list 'k:<keys>', where <keys> is a map of a list item's key fields to their unique values If a key maps to an empty Fields value, the field that key represents is part of the set.\n\nThe exact format is defined in sigs.k8s.io/structured-merge-diff",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "manager": {
+ "description": "Manager is an identifier of the workflow managing these fields.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operation": {
+ "description": "Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "subresource": {
+ "description": "Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "time": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "namespace": {
+ "description": "Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ownerReferences": {
+ "description": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
+ "items": {
+ "description": "OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.",
+ "properties": {
+ "apiVersion": {
+ "description": "API version of the referent.",
+ "type": "string"
+ },
+ "blockOwnerDeletion": {
+ "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "controller": {
+ "description": "If true, this reference points to the managing controller.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiVersion",
+ "kind",
+ "name",
+ "uid"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ },
+ "resourceVersion": {
+ "description": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "spec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object"
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "properties": {
+ "continue": {
+ "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "remainingItemCount": {
+ "description": "remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "resourceVersion": {
+ "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selfLink": {
+ "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceslicelist.json b/master-standalone/resourceslicelist.json
index eec6872779..06dae87c2f 100644
--- a/master-standalone/resourceslicelist.json
+++ b/master-standalone/resourceslicelist.json
@@ -295,327 +295,318 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
]
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ]
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ]
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic"
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -790,7 +781,7 @@
"type": "object"
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -823,7 +814,7 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -865,7 +856,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
@@ -931,7 +922,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master-standalone/resourceslicespec-resource-v1alpha3.json b/master-standalone/resourceslicespec-resource-v1alpha3.json
index d08fec0b68..0ff1071f7a 100644
--- a/master-standalone/resourceslicespec-resource-v1alpha3.json
+++ b/master-standalone/resourceslicespec-resource-v1alpha3.json
@@ -91,11 +91,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -125,16 +129,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -270,7 +270,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
@@ -535,11 +535,11 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
diff --git a/master-standalone/resourceslicespec-resource-v1beta1.json b/master-standalone/resourceslicespec-resource-v1beta1.json
index f3f55179ab..4f2e71990d 100644
--- a/master-standalone/resourceslicespec-resource-v1beta1.json
+++ b/master-standalone/resourceslicespec-resource-v1beta1.json
@@ -103,11 +103,15 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"description": "Counter describes a quantity associated with a device.",
@@ -137,16 +141,12 @@
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": [
@@ -282,7 +282,7 @@
"x-kubernetes-map-type": "atomic"
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
diff --git a/master-standalone/resourceslicespec-resource-v1beta2.json b/master-standalone/resourceslicespec-resource-v1beta2.json
new file mode 100644
index 0000000000..c1c8882fec
--- /dev/null
+++ b/master-standalone/resourceslicespec-resource-v1beta2.json
@@ -0,0 +1,571 @@
+{
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
+ "items": {
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
+ "properties": {
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "nodeSelectorTerms"
+ ],
+ "type": [
+ "object",
+ "null"
+ ],
+ "x-kubernetes-map-type": "atomic"
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master-standalone/resourceslicespec.json b/master-standalone/resourceslicespec.json
index f3f55179ab..c1c8882fec 100644
--- a/master-standalone/resourceslicespec.json
+++ b/master-standalone/resourceslicespec.json
@@ -13,327 +13,318 @@
"items": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "description": "BasicDevice defines one device instance.",
- "properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "boolean",
- "null"
- ]
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
},
- "attributes": {
- "additionalProperties": {
- "description": "DeviceAttribute must have exactly one field set.",
- "properties": {
- "bool": {
- "description": "BoolValue is a true/false value.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "int": {
- "description": "IntValue is a number.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "string": {
- "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
"type": [
"string",
"null"
]
},
- "version": {
- "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ {
"type": [
- "string",
+ "number",
"null"
]
}
- },
- "type": [
- "object",
- "null"
]
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ }
},
- "capacity": {
- "additionalProperties": {
- "description": "DeviceCapacity describes a quantity associated with a device.",
- "properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
- }
- },
- "required": [
- "value"
- ],
- "type": [
- "object",
- "null"
- ]
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
},
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": [
- "object",
- "null"
- ]
+ "counters": {
+ "additionalProperties": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "oneOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ ]
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
+ "properties": {
+ "nodeSelectorTerms": {
+ "description": "Required. A list of node selector terms. The terms are ORed.",
"items": {
- "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
"properties": {
- "counters": {
- "additionalProperties": {
- "description": "Counter describes a quantity associated with a device.",
+ "matchExpressions": {
+ "description": "A list of node selector requirements by node's labels.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
"properties": {
- "value": {
- "oneOf": [
- {
- "type": [
- "string",
- "null"
- ]
- },
- {
- "type": [
- "number",
- "null"
- ]
- }
- ]
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
- "value"
+ "key",
+ "operator"
],
"type": [
"object",
"null"
]
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
- "type": "object"
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
- }
- },
- "required": [
- "sharedCounter",
- "counters"
- ],
- "type": [
- "object",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": [
- "string",
- "null"
- ]
- },
- "nodeSelector": {
- "description": "A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.",
- "properties": {
- "nodeSelectorTerms": {
- "description": "Required. A list of node selector terms. The terms are ORed.",
- "items": {
- "description": "A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.",
- "properties": {
- "matchExpressions": {
- "description": "A list of node selector requirements by node's labels.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "key",
- "operator"
- ],
- "type": [
- "object",
- "null"
- ]
+ "matchFields": {
+ "description": "A list of node selector requirements by node's fields.",
+ "items": {
+ "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
+ "properties": {
+ "key": {
+ "description": "The label key that the selector applies to.",
+ "type": "string"
},
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "matchFields": {
- "description": "A list of node selector requirements by node's fields.",
- "items": {
- "description": "A node selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
- "properties": {
- "key": {
- "description": "The label key that the selector applies to.",
- "type": "string"
- },
- "operator": {
- "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
- "type": "string"
- },
- "values": {
- "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
- "items": {
- "type": [
- "string",
- "null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ "operator": {
+ "description": "Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.",
+ "type": "string"
+ },
+ "values": {
+ "description": "An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. If the operator is Gt or Lt, the values array must have a single element, which will be interpreted as an integer. This array is replaced during a strategic merge patch.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
},
- "required": [
- "key",
- "operator"
- ],
"type": [
- "object",
+ "array",
"null"
- ]
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- }
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "key",
+ "operator"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
},
"type": [
- "object",
+ "array",
"null"
],
- "x-kubernetes-map-type": "atomic"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- }
- },
- "required": [
- "nodeSelectorTerms"
- ],
- "type": [
- "object",
- "null"
- ],
- "x-kubernetes-map-type": "atomic"
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
- "properties": {
- "effect": {
- "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
- "type": "string"
- },
- "key": {
- "description": "The taint key to be applied to a device. Must be a label name.",
- "type": "string"
- },
- "timeAdded": {
- "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "value": {
- "description": "The taint value corresponding to the taint key. Must be a label value.",
- "type": [
- "string",
- "null"
- ]
+ "x-kubernetes-list-type": "atomic"
}
},
- "required": [
- "key",
- "effect"
- ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "type": [
- "array",
- "null"
- ],
+ "type": "array",
"x-kubernetes-list-type": "atomic"
}
},
+ "required": [
+ "nodeSelectorTerms"
+ ],
"type": [
"object",
"null"
- ]
+ ],
+ "x-kubernetes-map-type": "atomic"
},
- "name": {
- "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
- "type": "string"
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "description": "Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -514,7 +505,7 @@
]
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
@@ -547,7 +538,7 @@
"null"
]
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
diff --git a/master-standalone/watchevent-meta-v1.json b/master-standalone/watchevent-meta-v1.json
index d605bc46b3..120a50cf57 100644
--- a/master-standalone/watchevent-meta-v1.json
+++ b/master-standalone/watchevent-meta-v1.json
@@ -291,6 +291,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master-standalone/watchevent.json b/master-standalone/watchevent.json
index d605bc46b3..120a50cf57 100644
--- a/master-standalone/watchevent.json
+++ b/master-standalone/watchevent.json
@@ -291,6 +291,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master/_definitions.json b/master/_definitions.json
index 4b629a23e6..5c3d22900f 100644
--- a/master/_definitions.json
+++ b/master/_definitions.json
@@ -15396,8 +15396,8 @@
"description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
"type": "object"
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -15413,7 +15413,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
@@ -15456,11 +15456,11 @@
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": "object"
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": "string"
}
},
@@ -15731,20 +15731,20 @@
"io.k8s.api.resource.v1alpha3.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
"$ref": "#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
@@ -15857,7 +15857,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -16553,55 +16553,1078 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.BasicDevice": {
- "description": "BasicDevice defines one device instance.",
+ "io.k8s.api.resource.v1beta1.BasicDevice": {
+ "description": "BasicDevice defines one device instance.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Counter": {
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.CounterSet": {
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.Device": {
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "basic": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
+ "description": "Basic defines one device instance."
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": "boolean"
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": "string"
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": "string"
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": "object"
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequest": {
+ "description": "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.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "firstAvailable": {
+ "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": "string"
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": "string"
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": "string"
+ },
+ "timeAdded": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": "string"
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": "string"
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": "string"
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": "string"
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "parameters": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": "string"
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": "string"
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": "string"
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": "string"
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ },
+ "type": "array"
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": "string",
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta1"
+ }
+ ]
+ },
+ "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": "boolean"
+ },
+ "pool": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocatedDeviceStatus": {
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": "array",
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": "string"
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": "string"
+ },
+ "networkData": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.AllocationResult": {
+ "description": "AllocationResult contains attributes of an allocated resource.",
"properties": {
- "allNodes": {
- "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "boolean"
- },
- "attributes": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAttribute"
- },
- "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "capacity": {
- "additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCapacity"
- },
- "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
- "type": "object"
- },
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "nodeName": {
- "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
- "type": "string"
+ "devices": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
},
"nodeSelector": {
"$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
- },
- "taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CELDeviceSelector": {
+ "io.k8s.api.resource.v1beta2.CELDeviceSelector": {
"description": "CELDeviceSelector contains a CEL expression for selecting a device.",
"properties": {
"expression": {
@@ -16614,7 +17637,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Counter": {
+ "io.k8s.api.resource.v1beta2.Counter": {
"description": "Counter describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16627,14 +17650,14 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.CounterSet": {
+ "io.k8s.api.resource.v1beta2.CounterSet": {
"description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": "object"
},
"name": {
@@ -16648,16 +17671,54 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.Device": {
+ "io.k8s.api.resource.v1beta2.Device": {
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "boolean"
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": "object"
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
"type": "string"
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": "string"
+ },
+ "nodeSelector": {
+ "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16665,11 +17726,11 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration": {
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16690,13 +17751,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceAllocationResult": {
"description": "DeviceAllocationResult is the result of allocating devices.",
"properties": {
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16704,7 +17765,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16712,7 +17773,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceAttribute": {
+ "io.k8s.api.resource.v1beta2.DeviceAttribute": {
"description": "DeviceAttribute must have exactly one field set.",
"properties": {
"bool": {
@@ -16735,7 +17796,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCapacity": {
+ "io.k8s.api.resource.v1beta2.DeviceCapacity": {
"description": "DeviceCapacity describes a quantity associated with a device.",
"properties": {
"value": {
@@ -16748,13 +17809,13 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaim": {
+ "io.k8s.api.resource.v1beta2.DeviceClaim": {
"description": "DeviceClaim defines how to request devices with a ResourceClaim.",
"properties": {
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16762,7 +17823,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16770,7 +17831,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16778,11 +17839,11 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClaimConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClaimConfiguration": {
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
@@ -16796,7 +17857,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClass": {
+ "io.k8s.api.resource.v1beta2.DeviceClass": {
"description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -16815,7 +17876,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -16827,21 +17888,21 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassConfiguration": {
+ "io.k8s.api.resource.v1beta2.DeviceClassConfiguration": {
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceClassList": {
+ "io.k8s.api.resource.v1beta2.DeviceClassList": {
"description": "DeviceClassList is a collection of classes.",
"properties": {
"apiVersion": {
@@ -16851,7 +17912,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": "array"
},
@@ -16875,17 +17936,17 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.DeviceClassSpec": {
+ "io.k8s.api.resource.v1beta2.DeviceClassSpec": {
"description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
"properties": {
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16893,7 +17954,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -16901,7 +17962,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceConstraint": {
+ "io.k8s.api.resource.v1beta2.DeviceConstraint": {
"description": "DeviceConstraint must have exactly one field set besides Requests.",
"properties": {
"matchAttribute": {
@@ -16919,74 +17980,45 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceCounterConsumption": {
+ "io.k8s.api.resource.v1beta2.DeviceCounterConsumption": {
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": "string"
+ },
"counters": {
"additionalProperties": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": "object"
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": "string"
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequest": {
- "description": "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.",
+ "io.k8s.api.resource.v1beta2.DeviceRequest": {
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": "boolean"
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": "string"
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": "integer"
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": "string"
+ "exactly": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": "string"
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": "array",
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
@@ -16994,7 +18026,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult": {
+ "io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult": {
"description": "DeviceRequestAllocationResult contains the allocation result for one request.",
"properties": {
"adminAccess": {
@@ -17020,7 +18052,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17034,21 +18066,21 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSelector": {
+ "io.k8s.api.resource.v1beta2.DeviceSelector": {
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceSubRequest": {
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "io.k8s.api.resource.v1beta2.DeviceSubRequest": {
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": "string"
},
"count": {
@@ -17067,7 +18099,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17075,7 +18107,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17087,7 +18119,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceTaint": {
+ "io.k8s.api.resource.v1beta2.DeviceTaint": {
"description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
"properties": {
"effect": {
@@ -17113,7 +18145,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.DeviceToleration": {
+ "io.k8s.api.resource.v1beta2.DeviceToleration": {
"description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
"properties": {
"effect": {
@@ -17140,7 +18172,49 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.NetworkDeviceData": {
+ "io.k8s.api.resource.v1beta2.ExactDeviceRequest": {
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": "boolean"
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": "string"
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": "string"
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": "array",
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object"
+ },
+ "io.k8s.api.resource.v1beta2.NetworkDeviceData": {
"description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
"properties": {
"hardwareAddress": {
@@ -17152,7 +18226,7 @@
"type": "string"
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": "string"
},
@@ -17162,7 +18236,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration": {
+ "io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration": {
"description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
"properties": {
"driver": {
@@ -17180,7 +18254,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaim": {
+ "io.k8s.api.resource.v1beta2.ResourceClaim": {
"description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17199,11 +18273,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -17215,11 +18289,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference": {
"description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
"properties": {
"apiGroup": {
@@ -17246,7 +18320,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimList": {
"description": "ResourceClaimList is a collection of claims.",
"properties": {
"apiVersion": {
@@ -17256,7 +18330,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": "array"
},
@@ -17280,31 +18354,31 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimSpec": {
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimStatus": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimStatus": {
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17317,7 +18391,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": "array",
"x-kubernetes-list-map-keys": [
@@ -17330,7 +18404,7 @@
},
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplate": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplate": {
"description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17349,7 +18423,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -17361,11 +18435,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateList": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateList": {
"description": "ResourceClaimTemplateList is a collection of claim templates.",
"properties": {
"apiVersion": {
@@ -17375,7 +18449,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": "array"
},
@@ -17399,11 +18473,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec": {
"description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
"properties": {
"metadata": {
@@ -17411,7 +18485,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
@@ -17420,7 +18494,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourcePool": {
+ "io.k8s.api.resource.v1beta2.ResourcePool": {
"description": "ResourcePool describes the pool that ResourceSlices belong to.",
"properties": {
"generation": {
@@ -17445,7 +18519,7 @@
],
"type": "object"
},
- "io.k8s.api.resource.v1beta1.ResourceSlice": {
+ "io.k8s.api.resource.v1beta2.ResourceSlice": {
"description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
"properties": {
"apiVersion": {
@@ -17464,7 +18538,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -17476,11 +18550,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceList": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceList": {
"description": "ResourceSliceList is a collection of ResourceSlices.",
"properties": {
"apiVersion": {
@@ -17490,7 +18564,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": "array"
},
@@ -17514,11 +18588,11 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
]
},
- "io.k8s.api.resource.v1beta1.ResourceSliceSpec": {
+ "io.k8s.api.resource.v1beta2.ResourceSliceSpec": {
"description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
"properties": {
"allNodes": {
@@ -17528,7 +18602,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -17550,13 +18624,13 @@
"type": "boolean"
},
"pool": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": "array",
"x-kubernetes-list-type": "atomic"
@@ -19927,6 +21001,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
@@ -20682,6 +21761,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master/all.json b/master/all.json
index f834495d86..bd9f95f182 100644
--- a/master/all.json
+++ b/master/all.json
@@ -1734,6 +1734,123 @@
{
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec"
},
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassList"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimList"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateList"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceList"
+ },
+ {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec"
+ },
{
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.scheduling.v1.PriorityClass"
},
diff --git a/master/allocateddevicestatus-resource-v1beta2.json b/master/allocateddevicestatus-resource-v1beta2.json
new file mode 100644
index 0000000000..d2b0f7c5b3
--- /dev/null
+++ b/master/allocateddevicestatus-resource-v1beta2.json
@@ -0,0 +1,55 @@
+{
+ "description": "AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information.",
+ "properties": {
+ "conditions": {
+ "description": "Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the `Ready` condition should be True.\n\nMust not contain more than 8 entries.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Condition"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "type"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "data": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Data contains arbitrary driver-specific data.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "networkData": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
+ "description": "NetworkData contains network-related information specific to the device."
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/allocateddevicestatus.json b/master/allocateddevicestatus.json
index 59ca9feab7..d2b0f7c5b3 100644
--- a/master/allocateddevicestatus.json
+++ b/master/allocateddevicestatus.json
@@ -34,7 +34,7 @@
]
},
"networkData": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.NetworkDeviceData",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.NetworkDeviceData",
"description": "NetworkData contains network-related information specific to the device."
},
"pool": {
diff --git a/master/allocationresult-resource-v1beta2.json b/master/allocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..33c2747e91
--- /dev/null
+++ b/master/allocationresult-resource-v1beta2.json
@@ -0,0 +1,15 @@
+{
+ "description": "AllocationResult contains attributes of an allocated resource.",
+ "properties": {
+ "devices": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
+ "description": "Devices is the result of allocating devices."
+ },
+ "nodeSelector": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines where the allocated resources are available. If unset, they are available everywhere."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/allocationresult.json b/master/allocationresult.json
index 4625432305..33c2747e91 100644
--- a/master/allocationresult.json
+++ b/master/allocationresult.json
@@ -2,7 +2,7 @@
"description": "AllocationResult contains attributes of an allocated resource.",
"properties": {
"devices": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationResult",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationResult",
"description": "Devices is the result of allocating devices."
},
"nodeSelector": {
diff --git a/master/basicdevice-resource-v1alpha3.json b/master/basicdevice-resource-v1alpha3.json
index 98717eec36..c97638577b 100644
--- a/master/basicdevice-resource-v1alpha3.json
+++ b/master/basicdevice-resource-v1alpha3.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.DeviceCounterConsumption"
},
@@ -51,7 +51,7 @@
"description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.DeviceTaint"
},
diff --git a/master/basicdevice-resource-v1beta1.json b/master/basicdevice-resource-v1beta1.json
index 607b9cfde7..8c27684bd9 100644
--- a/master/basicdevice-resource-v1beta1.json
+++ b/master/basicdevice-resource-v1beta1.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
},
@@ -48,10 +48,10 @@
},
"nodeSelector": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
},
diff --git a/master/basicdevice.json b/master/basicdevice.json
index 607b9cfde7..8c27684bd9 100644
--- a/master/basicdevice.json
+++ b/master/basicdevice.json
@@ -28,8 +28,8 @@
"null"
]
},
- "consumesCounter": {
- "description": "ConsumesCounter defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe maximum number of device counter consumption entries is 32. This is the same as the maximum number of shared counters allowed in a ResourceSlice.",
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceCounterConsumption"
},
@@ -48,10 +48,10 @@
},
"nodeSelector": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
- "description": "NodeSelector defines the nodes where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
},
"taints": {
- "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 8.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceTaint"
},
diff --git a/master/celdeviceselector-resource-v1beta2.json b/master/celdeviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..b63da15344
--- /dev/null
+++ b/master/celdeviceselector-resource-v1beta2.json
@@ -0,0 +1,17 @@
+{
+ "description": "CELDeviceSelector contains a CEL expression for selecting a device.",
+ "properties": {
+ "expression": {
+ "description": "Expression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other result is an error and causes allocation of devices to abort.\n\nThe expression's input is an object named \"device\", which carries the following properties:\n - driver (string): the name of the driver which defines this device.\n - attributes (map[string]object): the device's attributes, grouped by prefix\n (e.g. device.attributes[\"dra.example.com\"] evaluates to an object with all\n of the attributes which were prefixed by \"dra.example.com\".\n - capacity (map[string]object): the device's capacities, grouped by prefix.\n\nExample: Consider a device with driver=\"dra.example.com\", which exposes two attributes named \"model\" and \"ext.example.com/family\" and which exposes one capacity named \"modules\". This input to this expression would have the following fields:\n\n device.driver\n device.attributes[\"dra.example.com\"].model\n device.attributes[\"ext.example.com\"].family\n device.capacity[\"dra.example.com\"].modules\n\nThe device.driver field can be used to check for a specific driver, either as a high-level precondition (i.e. you only want to consider devices from this driver) or as part of a multi-clause expression that is meant to consider devices from different drivers.\n\nThe value type of each attribute is defined by the device definition, and users who write these expressions must consult the documentation for their specific drivers. The value type of each capacity is Quantity.\n\nIf an unknown prefix is used as a lookup in either device.attributes or device.capacity, an empty map will be returned. Any reference to an unknown field will cause an evaluation error and allocation to abort.\n\nA robust expression should check for the existence of attributes before referencing them.\n\nFor ease of use, the cel.bind() function is enabled, and can be used to simplify expressions that access multiple attributes with the same domain. For example:\n\n cel.bind(dra, device.attributes[\"dra.example.com\"], dra.someBool && dra.anotherBool)\n\nThe 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.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "expression"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/counter-resource-v1beta2.json b/master/counter-resource-v1beta2.json
new file mode 100644
index 0000000000..7830f80b9c
--- /dev/null
+++ b/master/counter-resource-v1beta2.json
@@ -0,0 +1,14 @@
+{
+ "description": "Counter describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device counter is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/counterset-resource-v1alpha3.json b/master/counterset-resource-v1alpha3.json
index 7fe2ede345..c56d0e921b 100644
--- a/master/counterset-resource-v1alpha3.json
+++ b/master/counterset-resource-v1alpha3.json
@@ -5,14 +5,14 @@
"additionalProperties": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device. The name of each counter must be unique in that set and must be a DNS label.\n\nTo ensure this uniqueness, capacities defined by the vendor must be listed without the driver name as domain prefix in their name. All others must be listed with their domain prefix.\n\nThe maximum number of counters is 32.",
"type": [
"object",
"null"
]
},
"name": {
- "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
"string",
"null"
diff --git a/master/counterset-resource-v1beta2.json b/master/counterset-resource-v1beta2.json
new file mode 100644
index 0000000000..d381cad58d
--- /dev/null
+++ b/master/counterset-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "CounterSet defines a named set of counters that are available to be used by devices defined in the ResourceSlice.\n\nThe counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.",
+ "properties": {
+ "counters": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name defines the name of the counter set. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/counterset.json b/master/counterset.json
index 27584b3b51..d381cad58d 100644
--- a/master/counterset.json
+++ b/master/counterset.json
@@ -3,9 +3,9 @@
"properties": {
"counters": {
"additionalProperties": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
},
- "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters is 32.",
+ "description": "Counters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label.\n\nThe maximum number of counters in all sets is 32.",
"type": [
"object",
"null"
diff --git a/master/deleteoptions-meta-v1.json b/master/deleteoptions-meta-v1.json
index e76348aabc..e055e49040 100644
--- a/master/deleteoptions-meta-v1.json
+++ b/master/deleteoptions-meta-v1.json
@@ -62,6 +62,7 @@
"rbac.authorization.k8s.io/v1beta1",
"resource.k8s.io/v1alpha3",
"resource.k8s.io/v1beta1",
+ "resource.k8s.io/v1beta2",
"scheduling.k8s.io/v1",
"scheduling.k8s.io/v1alpha1",
"scheduling.k8s.io/v1beta1",
@@ -401,6 +402,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master/deleteoptions.json b/master/deleteoptions.json
index fa91a05a89..91d71ee1c7 100644
--- a/master/deleteoptions.json
+++ b/master/deleteoptions.json
@@ -338,6 +338,11 @@
"kind": "DeleteOptions",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeleteOptions",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "DeleteOptions",
diff --git a/master/device-resource-v1beta2.json b/master/device-resource-v1beta2.json
new file mode 100644
index 0000000000..24de083a86
--- /dev/null
+++ b/master/device-resource-v1beta2.json
@@ -0,0 +1,77 @@
+{
+ "description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/device.json b/master/device.json
index a78dbbe265..24de083a86 100644
--- a/master/device.json
+++ b/master/device.json
@@ -1,9 +1,43 @@
{
"description": "Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.",
"properties": {
- "basic": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.BasicDevice",
- "description": "Basic defines one device instance."
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the device.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "attributes": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAttribute"
+ },
+ "description": "Attributes defines the set of attributes for this device. The name of each attribute must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "capacity": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCapacity"
+ },
+ "description": "Capacity defines the set of capacities for this device. The name of each capacity must be unique in that set.\n\nThe maximum number of attributes and capacities combined is 32.",
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "consumesCounters": {
+ "description": "ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets.\n\nThere can only be a single entry per counterSet.\n\nThe total number of device counter consumption entries must be <= 32. In addition, the total number in the entire ResourceSlice must be <= 1024 (for example, 64 devices with 16 counters each).",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceCounterConsumption"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
},
"name": {
"description": "Name is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.",
@@ -11,6 +45,28 @@
"string",
"null"
]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node where the device is available.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines the nodes where the device is available.\n\nMust use exactly one term.\n\nMust only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set."
+ },
+ "taints": {
+ "description": "If specified, these are the driver-defined taints.\n\nThe maximum number of taints is 4.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceTaint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master/deviceallocationconfiguration-resource-v1beta2.json b/master/deviceallocationconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..80420191a1
--- /dev/null
+++ b/master/deviceallocationconfiguration-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
+ "properties": {
+ "opaque": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, its applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "source": {
+ "description": "Source records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "source"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceallocationconfiguration.json b/master/deviceallocationconfiguration.json
index a511a44f7f..80420191a1 100644
--- a/master/deviceallocationconfiguration.json
+++ b/master/deviceallocationconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceAllocationConfiguration gets embedded in an AllocationResult.",
"properties": {
"opaque": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
diff --git a/master/deviceallocationresult-resource-v1beta2.json b/master/deviceallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..40b852bf85
--- /dev/null
+++ b/master/deviceallocationresult-resource-v1beta2.json
@@ -0,0 +1,29 @@
+{
+ "description": "DeviceAllocationResult is the result of allocating devices.",
+ "properties": {
+ "config": {
+ "description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "results": {
+ "description": "Results lists all allocated devices.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceallocationresult.json b/master/deviceallocationresult.json
index 00efc3eb67..40b852bf85 100644
--- a/master/deviceallocationresult.json
+++ b/master/deviceallocationresult.json
@@ -4,7 +4,7 @@
"config": {
"description": "This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag.\n\nThis includes configuration parameters for drivers which have no allocated devices in the result because it is up to the drivers which configuration parameters they support. They can silently ignore unknown configuration parameters.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceAllocationConfiguration"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceAllocationConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"results": {
"description": "Results lists all allocated devices.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceRequestAllocationResult"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequestAllocationResult"
},
"type": [
"array",
diff --git a/master/deviceattribute-resource-v1beta2.json b/master/deviceattribute-resource-v1beta2.json
new file mode 100644
index 0000000000..4ad000a165
--- /dev/null
+++ b/master/deviceattribute-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "DeviceAttribute must have exactly one field set.",
+ "properties": {
+ "bool": {
+ "description": "BoolValue is a true/false value.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "int": {
+ "description": "IntValue is a number.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "string": {
+ "description": "StringValue is a string. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "description": "VersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicecapacity-resource-v1beta2.json b/master/devicecapacity-resource-v1beta2.json
new file mode 100644
index 0000000000..c66b27da49
--- /dev/null
+++ b/master/devicecapacity-resource-v1beta2.json
@@ -0,0 +1,14 @@
+{
+ "description": "DeviceCapacity describes a quantity associated with a device.",
+ "properties": {
+ "value": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity",
+ "description": "Value defines how much of a certain device capacity is available."
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclaim-resource-v1beta2.json b/master/deviceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..8b828d37d8
--- /dev/null
+++ b/master/deviceclaim-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "DeviceClaim defines how to request devices with a ResourceClaim.",
+ "properties": {
+ "config": {
+ "description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "constraints": {
+ "description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "requests": {
+ "description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclaim.json b/master/deviceclaim.json
index 5fd070eb45..8b828d37d8 100644
--- a/master/deviceclaim.json
+++ b/master/deviceclaim.json
@@ -4,7 +4,7 @@
"config": {
"description": "This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClaimConfiguration"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaimConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"constraints": {
"description": "These constraints must be satisfied by the set of devices that get allocated for the claim.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceConstraint"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceConstraint"
},
"type": [
"array",
@@ -26,7 +26,7 @@
"requests": {
"description": "Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceRequest"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceRequest"
},
"type": [
"array",
diff --git a/master/deviceclaimconfiguration-resource-v1beta2.json b/master/deviceclaimconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..4789ff9e9e
--- /dev/null
+++ b/master/deviceclaimconfiguration-resource-v1beta2.json
@@ -0,0 +1,25 @@
+{
+ "description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
+ "properties": {
+ "opaque": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ },
+ "requests": {
+ "description": "Requests lists the names of requests where the configuration applies. If empty, it applies to all requests.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the configuration applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclaimconfiguration.json b/master/deviceclaimconfiguration.json
index 4659355ddf..4789ff9e9e 100644
--- a/master/deviceclaimconfiguration.json
+++ b/master/deviceclaimconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.",
"properties": {
"opaque": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
},
"requests": {
diff --git a/master/deviceclass-resource-v1beta2.json b/master/deviceclass-resource-v1beta2.json
new file mode 100644
index 0000000000..de5a338476
--- /dev/null
+++ b/master/deviceclass-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClass"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
+ "description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClass",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclass.json b/master/deviceclass.json
index d188029356..e7be60ef0f 100644
--- a/master/deviceclass.json
+++ b/master/deviceclass.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClassSpec",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassSpec",
"description": "Spec defines what can be allocated and how to configure it.\n\nThis is mutable. Consumers have to be prepared for classes changing at any time, either because they get updated or replaced. Claim allocations are done once based on whatever was set in classes at the time of allocation.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClass",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/deviceclassconfiguration-resource-v1beta2.json b/master/deviceclassconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..2d247f361d
--- /dev/null
+++ b/master/deviceclassconfiguration-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "DeviceClassConfiguration is used in DeviceClass.",
+ "properties": {
+ "opaque": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
+ "description": "Opaque provides driver-specific configuration parameters."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclassconfiguration.json b/master/deviceclassconfiguration.json
index 6de6a33907..2d247f361d 100644
--- a/master/deviceclassconfiguration.json
+++ b/master/deviceclassconfiguration.json
@@ -2,7 +2,7 @@
"description": "DeviceClassConfiguration is used in DeviceClass.",
"properties": {
"opaque": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.OpaqueDeviceConfiguration",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.OpaqueDeviceConfiguration",
"description": "Opaque provides driver-specific configuration parameters."
}
},
diff --git a/master/deviceclasslist-resource-v1beta2.json b/master/deviceclasslist-resource-v1beta2.json
new file mode 100644
index 0000000000..0132a22a8b
--- /dev/null
+++ b/master/deviceclasslist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "DeviceClassList is a collection of classes.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource classes.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "DeviceClassList"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "DeviceClassList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclasslist.json b/master/deviceclasslist.json
index 59642e5250..67d1f5babb 100644
--- a/master/deviceclasslist.json
+++ b/master/deviceclasslist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource classes.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClass"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClass"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "DeviceClassList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/deviceclassspec-resource-v1beta2.json b/master/deviceclassspec-resource-v1beta2.json
new file mode 100644
index 0000000000..73fb9a0ff7
--- /dev/null
+++ b/master/deviceclassspec-resource-v1beta2.json
@@ -0,0 +1,29 @@
+{
+ "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
+ "properties": {
+ "config": {
+ "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "selectors": {
+ "description": "Each selector must be satisfied by a device which is claimed via this class.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceclassspec.json b/master/deviceclassspec.json
index 242b31d89e..73fb9a0ff7 100644
--- a/master/deviceclassspec.json
+++ b/master/deviceclassspec.json
@@ -4,7 +4,7 @@
"config": {
"description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClassConfiguration"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClassConfiguration"
},
"type": [
"array",
@@ -15,7 +15,7 @@
"selectors": {
"description": "Each selector must be satisfied by a device which is claimed via this class.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": [
"array",
diff --git a/master/deviceconstraint-resource-v1beta2.json b/master/deviceconstraint-resource-v1beta2.json
new file mode 100644
index 0000000000..9603a6111e
--- /dev/null
+++ b/master/deviceconstraint-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceConstraint must have exactly one field set besides Requests.",
+ "properties": {
+ "matchAttribute": {
+ "description": "MatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices.\n\nFor example, if you specified \"dra.example.com/numa\" (a hypothetical example!), then only devices in the same NUMA node will be chosen. A device which does not have that attribute will not be chosen. All devices should use a value of the same type for this attribute because that is part of its specification, but if one device doesn't, then it also will not be chosen.\n\nMust include the domain qualifier.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requests": {
+ "description": "Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint. If this is not specified, this constraint applies to all requests in this claim.\n\nReferences to subrequests must include the name of the main request and may include the subrequest using the format <main request>[/<subrequest>]. If just the main request is given, the constraint applies to all subrequests.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicecounterconsumption-resource-v1alpha3.json b/master/devicecounterconsumption-resource-v1alpha3.json
index ffc9eabfa7..b4915413c2 100644
--- a/master/devicecounterconsumption-resource-v1alpha3.json
+++ b/master/devicecounterconsumption-resource-v1alpha3.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet defines the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1alpha3.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master/devicecounterconsumption-resource-v1beta1.json b/master/devicecounterconsumption-resource-v1beta1.json
index 17a28bf212..e5ba3c8d82 100644
--- a/master/devicecounterconsumption-resource-v1beta1.json
+++ b/master/devicecounterconsumption-resource-v1beta1.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
"counters": {
"additionalProperties": {
"$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
},
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
"object",
"null"
]
- },
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
- "type": [
- "string",
- "null"
- ]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master/devicecounterconsumption-resource-v1beta2.json b/master/devicecounterconsumption-resource-v1beta2.json
new file mode 100644
index 0000000000..1414c48015
--- /dev/null
+++ b/master/devicecounterconsumption-resource-v1beta2.json
@@ -0,0 +1,28 @@
+{
+ "description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
+ "properties": {
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "counters": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "counterSet",
+ "counters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicecounterconsumption.json b/master/devicecounterconsumption.json
index 17a28bf212..1414c48015 100644
--- a/master/devicecounterconsumption.json
+++ b/master/devicecounterconsumption.json
@@ -1,26 +1,26 @@
{
"description": "DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.",
"properties": {
- "counters": {
- "additionalProperties": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Counter"
- },
- "description": "Counters defines the Counter that will be consumed by the device.\n\nThe maximum number of Counters is 32.",
+ "counterSet": {
+ "description": "CounterSet is the name of the set from which the counters defined will be consumed.",
"type": [
- "object",
+ "string",
"null"
]
},
- "sharedCounter": {
- "description": "SharedCounter defines the shared counter from which the counters defined will be consumed.",
+ "counters": {
+ "additionalProperties": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Counter"
+ },
+ "description": "Counters defines the counters that will be consumed by the device.\n\nThe maximum number counters in a device is 32. In addition, the maximum number of all counters in all devices is 1024 (for example, 64 devices with 16 counters each).",
"type": [
- "string",
+ "object",
"null"
]
}
},
"required": [
- "sharedCounter",
+ "counterSet",
"counters"
],
"type": "object",
diff --git a/master/devicerequest-resource-v1beta2.json b/master/devicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..4b4d307c51
--- /dev/null
+++ b/master/devicerequest-resource-v1beta2.json
@@ -0,0 +1,32 @@
+{
+ "description": "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.",
+ "properties": {
+ "exactly": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
+ },
+ "firstAvailable": {
+ "description": "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.\n\nDRA 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.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "name": {
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicerequest.json b/master/devicerequest.json
index c168971eb3..4b4d307c51 100644
--- a/master/devicerequest.json
+++ b/master/devicerequest.json
@@ -1,39 +1,14 @@
{
- "description": "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.",
+ "description": "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.",
"properties": {
- "adminAccess": {
- "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
- "type": [
- "boolean",
- "null"
- ]
- },
- "allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "format": "int64",
- "type": [
- "integer",
- "null"
- ]
- },
- "deviceClassName": {
- "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA class is required if no subrequests are specified in the firstAvailable list and no class can be set if subrequests are specified in the firstAvailable list. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
- "type": [
- "string",
- "null"
- ]
+ "exactly": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ExactDeviceRequest",
+ "description": "Exactly specifies the details for a single request that must be met exactly for the request to be satisfied.\n\nOne of Exactly or FirstAvailable must be set."
},
"firstAvailable": {
- "description": "FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. 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 cannot be used.\n\nThis field may only be set in the entries of DeviceClaim.Requests.\n\nDRA 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.",
+ "description": "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.\n\nDRA 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.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSubRequest"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSubRequest"
},
"type": [
"array",
@@ -42,33 +17,11 @@
"x-kubernetes-list-type": "atomic"
},
"name": {
- "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nMust be a DNS label and unique among all DeviceRequests in a ResourceClaim.",
+ "description": "Name can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim.\n\nReferences 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.\n\nMust be a DNS label.",
"type": [
"string",
"null"
]
- },
- "selectors": {
- "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.",
- "items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
- },
- "tolerations": {
- "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis field can only be set when deviceClassName is set and no subrequests are specified in the firstAvailable list.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
- "items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
- },
- "type": [
- "array",
- "null"
- ],
- "x-kubernetes-list-type": "atomic"
}
},
"required": [
diff --git a/master/devicerequestallocationresult-resource-v1beta2.json b/master/devicerequestallocationresult-resource-v1beta2.json
new file mode 100644
index 0000000000..3c5d6043b3
--- /dev/null
+++ b/master/devicerequestallocationresult-resource-v1beta2.json
@@ -0,0 +1,59 @@
+{
+ "description": "DeviceRequestAllocationResult contains the allocation result for one request.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "device": {
+ "description": "Device references one device instance via its name in the driver's resource pool. It must be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "driver": {
+ "description": "Driver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "pool": {
+ "description": "This name together with the driver name and the device name field identify which device was allocated (`<driver name>/<pool name>/<device name>`).\n\nMust not be longer than 253 characters and may contain one or more DNS sub-domains separated by slashes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "request": {
+ "description": "Request is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the name of the main request and the subrequest using the format <main request>/<subrequest>.\n\nMultiple devices may have been allocated per request.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerations": {
+ "description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "request",
+ "driver",
+ "pool",
+ "device"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicerequestallocationresult.json b/master/devicerequestallocationresult.json
index b78fd6b7b4..3c5d6043b3 100644
--- a/master/devicerequestallocationresult.json
+++ b/master/devicerequestallocationresult.json
@@ -39,7 +39,7 @@
"tolerations": {
"description": "A copy of all tolerations specified in the request at the time when the device got allocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": [
"array",
diff --git a/master/deviceselector-resource-v1beta2.json b/master/deviceselector-resource-v1beta2.json
new file mode 100644
index 0000000000..a61316da24
--- /dev/null
+++ b/master/deviceselector-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "DeviceSelector must have exactly one field set.",
+ "properties": {
+ "cel": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
+ "description": "CEL contains a CEL expression for selecting a device."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/deviceselector.json b/master/deviceselector.json
index eb87b55981..a61316da24 100644
--- a/master/deviceselector.json
+++ b/master/deviceselector.json
@@ -2,7 +2,7 @@
"description": "DeviceSelector must have exactly one field set.",
"properties": {
"cel": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.CELDeviceSelector",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CELDeviceSelector",
"description": "CEL contains a CEL expression for selecting a device."
}
},
diff --git a/master/devicesubrequest-resource-v1alpha3.json b/master/devicesubrequest-resource-v1alpha3.json
index d90826a61c..c08523b628 100644
--- a/master/devicesubrequest-resource-v1alpha3.json
+++ b/master/devicesubrequest-resource-v1alpha3.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master/devicesubrequest-resource-v1beta1.json b/master/devicesubrequest-resource-v1beta1.json
index fc90df4fdf..1f58bc2806 100644
--- a/master/devicesubrequest-resource-v1beta1.json
+++ b/master/devicesubrequest-resource-v1beta1.json
@@ -2,7 +2,7 @@
"description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
diff --git a/master/devicesubrequest-resource-v1beta2.json b/master/devicesubrequest-resource-v1beta2.json
new file mode 100644
index 0000000000..0769991645
--- /dev/null
+++ b/master/devicesubrequest-resource-v1beta2.json
@@ -0,0 +1,62 @@
+{
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
+ "properties": {
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest.\n\nA class is required. Which classes are available depends on the cluster.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format <main request>/<subrequest>.\n\nMust be a DNS label.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "name",
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicesubrequest.json b/master/devicesubrequest.json
index fc90df4fdf..0769991645 100644
--- a/master/devicesubrequest.json
+++ b/master/devicesubrequest.json
@@ -1,8 +1,8 @@
{
- "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.",
+ "description": "DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices.\n\nDeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.",
"properties": {
"allocationMode": {
- "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AlloctionMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This subrequest is for all of the matching devices in a pool.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other subrequests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
"type": [
"string",
"null"
@@ -33,7 +33,7 @@
"selectors": {
"description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceSelector"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
},
"type": [
"array",
@@ -44,7 +44,7 @@
"tolerations": {
"description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceToleration"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
},
"type": [
"array",
diff --git a/master/devicetaint-resource-v1beta2.json b/master/devicetaint-resource-v1beta2.json
new file mode 100644
index 0000000000..9c85a76ae9
--- /dev/null
+++ b/master/devicetaint-resource-v1beta2.json
@@ -0,0 +1,36 @@
+{
+ "description": "The device this taint is attached to has the \"effect\" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.",
+ "properties": {
+ "effect": {
+ "description": "The effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are NoSchedule and NoExecute. PreferNoSchedule as used for nodes is not valid here.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "The taint key to be applied to a device. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "timeAdded": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
+ "description": "TimeAdded represents the time at which the taint was added. Added automatically during create or update if not set."
+ },
+ "value": {
+ "description": "The taint value corresponding to the taint key. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "key",
+ "effect"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/devicetoleration-resource-v1beta2.json b/master/devicetoleration-resource-v1beta2.json
new file mode 100644
index 0000000000..8fb10b765d
--- /dev/null
+++ b/master/devicetoleration-resource-v1beta2.json
@@ -0,0 +1,43 @@
+{
+ "description": "The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.",
+ "properties": {
+ "effect": {
+ "description": "Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "key": {
+ "description": "Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys. Must be a label name.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "operator": {
+ "description": "Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a ResourceClaim can tolerate all taints of a particular category.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tolerationSeconds": {
+ "description": "TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system. If larger than zero, the time when the pod needs to be evicted is calculated as <time when taint was adedd> + <toleration seconds>.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "Value is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/exactdevicerequest-resource-v1beta2.json b/master/exactdevicerequest-resource-v1beta2.json
new file mode 100644
index 0000000000..17217ea50b
--- /dev/null
+++ b/master/exactdevicerequest-resource-v1beta2.json
@@ -0,0 +1,61 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/exactdevicerequest.json b/master/exactdevicerequest.json
new file mode 100644
index 0000000000..17217ea50b
--- /dev/null
+++ b/master/exactdevicerequest.json
@@ -0,0 +1,61 @@
+{
+ "description": "ExactDeviceRequest is a request for one or more identical devices.",
+ "properties": {
+ "adminAccess": {
+ "description": "AdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They ignore all ordinary claims to the device with respect to access modes and any resource allocations.\n\nThis is an alpha field and requires enabling the DRAAdminAccess feature gate. Admin access is disabled if this field is unset or set to false, otherwise it is enabled.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "allocationMode": {
+ "description": "AllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are:\n\n- ExactCount: This request is for a specific number of devices.\n This is the default. The exact number is provided in the\n count field.\n\n- All: This request is for all of the matching devices in a pool.\n At least one device must exist on the node for the allocation to succeed.\n Allocation will fail if some devices are already allocated,\n unless adminAccess is requested.\n\nIf AllocationMode is not specified, the default mode is ExactCount. If the mode is ExactCount and count is not specified, the default count is one. Any other requests must specify this field.\n\nMore modes may get added in the future. Clients must refuse to handle requests with unknown modes.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "description": "Count is used only when the count mode is \"ExactCount\". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "deviceClassName": {
+ "description": "DeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request.\n\nA DeviceClassName is required.\n\nAdministrators may use this to restrict which devices may get requested by only installing classes with selectors for permitted devices. If users are free to request anything without restrictions, then administrators can create an empty DeviceClass for users to reference.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "selectors": {
+ "description": "Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceSelector"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "tolerations": {
+ "description": "If specified, the request's tolerations.\n\nTolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute.\n\nIn addition, should any of the allocated devices get tainted with NoExecute after allocation and that effect is not tolerated, then all pods consuming the ResourceClaim get deleted to evict them. The scheduler will not let new pods reserve the claim while it has these tainted devices. Once all pods are evicted, the claim will get deallocated.\n\nThe maximum number of tolerations is 16.\n\nThis is an alpha field and requires enabling the DRADeviceTaints feature gate.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceToleration"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "deviceClassName"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/networkdevicedata-resource-v1beta2.json b/master/networkdevicedata-resource-v1beta2.json
new file mode 100644
index 0000000000..b291f267e3
--- /dev/null
+++ b/master/networkdevicedata-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.",
+ "properties": {
+ "hardwareAddress": {
+ "description": "HardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface.\n\nMust not be longer than 128 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "interfaceName": {
+ "description": "InterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod.\n\nMust not be longer than 256 characters.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ips": {
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
+ "items": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/networkdevicedata.json b/master/networkdevicedata.json
index ea6cc68bbd..b291f267e3 100644
--- a/master/networkdevicedata.json
+++ b/master/networkdevicedata.json
@@ -16,7 +16,7 @@
]
},
"ips": {
- "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.\n\nMust not contain more than 16 entries.",
+ "description": "IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the associated subnet mask. e.g.: \"192.0.2.5/24\" for IPv4 and \"2001:db8::5/64\" for IPv6.",
"items": {
"type": [
"string",
diff --git a/master/opaquedeviceconfiguration-resource-v1beta2.json b/master/opaquedeviceconfiguration-resource-v1beta2.json
new file mode 100644
index 0000000000..d58b137d7e
--- /dev/null
+++ b/master/opaquedeviceconfiguration-resource-v1beta2.json
@@ -0,0 +1,22 @@
+{
+ "description": "OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.",
+ "properties": {
+ "driver": {
+ "description": "Driver is used to determine which kubelet plugin needs to be passed these configuration parameters.\n\nAn admission policy provided by the driver developer could use this to decide whether it needs to validate them.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parameters": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.runtime.RawExtension",
+ "description": "Parameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version (\"kind\" + \"apiVersion\" for Kubernetes types), with conversion between different versions.\n\nThe length of the raw data must be smaller or equal to 10 Ki."
+ }
+ },
+ "required": [
+ "driver",
+ "parameters"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaim-resource-v1beta2.json b/master/resourceclaim-resource-v1beta2.json
new file mode 100644
index 0000000000..f92cc43614
--- /dev/null
+++ b/master/resourceclaim-resource-v1beta2.json
@@ -0,0 +1,49 @@
+{
+ "description": "ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaim"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
+ "description": "Spec describes what is being requested and how to configure it. The spec is immutable."
+ },
+ "status": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
+ "description": "Status describes whether the claim is ready to use and what has been allocated."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaim",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaim.json b/master/resourceclaim.json
index b2f555117b..95a5a6b22a 100644
--- a/master/resourceclaim.json
+++ b/master/resourceclaim.json
@@ -23,11 +23,11 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec describes what is being requested and how to configure it. The spec is immutable."
},
"status": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimStatus",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimStatus",
"description": "Status describes whether the claim is ready to use and what has been allocated."
}
},
@@ -39,7 +39,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaim",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceclaimconsumerreference-resource-v1beta2.json b/master/resourceclaimconsumerreference-resource-v1beta2.json
new file mode 100644
index 0000000000..c7b403264b
--- /dev/null
+++ b/master/resourceclaimconsumerreference-resource-v1beta2.json
@@ -0,0 +1,40 @@
+{
+ "description": "ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.",
+ "properties": {
+ "apiGroup": {
+ "description": "APIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is the name of resource being referenced.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resource": {
+ "description": "Resource is the type of resource being referenced, for example \"pods\".",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uid": {
+ "description": "UID identifies exactly one incarnation of the resource.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "resource",
+ "name",
+ "uid"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimlist-resource-v1beta2.json b/master/resourceclaimlist-resource-v1beta2.json
new file mode 100644
index 0000000000..9ecef2bd00
--- /dev/null
+++ b/master/resourceclaimlist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceClaimList is a collection of claims.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claims.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimList"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimlist.json b/master/resourceclaimlist.json
index 6e97d5d9a4..e57be98fa2 100644
--- a/master/resourceclaimlist.json
+++ b/master/resourceclaimlist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource claims.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaim"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaim"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceclaimspec-resource-v1beta2.json b/master/resourceclaimspec-resource-v1beta2.json
new file mode 100644
index 0000000000..1eec0b66fd
--- /dev/null
+++ b/master/resourceclaimspec-resource-v1beta2.json
@@ -0,0 +1,11 @@
+{
+ "description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
+ "properties": {
+ "devices": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
+ "description": "Devices defines how to request devices."
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimspec.json b/master/resourceclaimspec.json
index 98f40c5d3f..1eec0b66fd 100644
--- a/master/resourceclaimspec.json
+++ b/master/resourceclaimspec.json
@@ -2,7 +2,7 @@
"description": "ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.",
"properties": {
"devices": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.DeviceClaim",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.DeviceClaim",
"description": "Devices defines how to request devices."
}
},
diff --git a/master/resourceclaimstatus-resource-v1beta2.json b/master/resourceclaimstatus-resource-v1beta2.json
new file mode 100644
index 0000000000..e65cd418a8
--- /dev/null
+++ b/master/resourceclaimstatus-resource-v1beta2.json
@@ -0,0 +1,43 @@
+{
+ "description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
+ "properties": {
+ "allocation": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
+ "description": "Allocation is set once the claim has been allocated successfully."
+ },
+ "devices": {
+ "description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "driver",
+ "device",
+ "pool"
+ ],
+ "x-kubernetes-list-type": "map"
+ },
+ "reservedFor": {
+ "description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-map-keys": [
+ "uid"
+ ],
+ "x-kubernetes-list-type": "map",
+ "x-kubernetes-patch-merge-key": "uid",
+ "x-kubernetes-patch-strategy": "merge"
+ }
+ },
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimstatus.json b/master/resourceclaimstatus.json
index be4981f388..e65cd418a8 100644
--- a/master/resourceclaimstatus.json
+++ b/master/resourceclaimstatus.json
@@ -2,13 +2,13 @@
"description": "ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.",
"properties": {
"allocation": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.AllocationResult",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocationResult",
"description": "Allocation is set once the claim has been allocated successfully."
},
"devices": {
"description": "Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.AllocatedDeviceStatus"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.AllocatedDeviceStatus"
},
"type": [
"array",
@@ -24,7 +24,7 @@
"reservedFor": {
"description": "ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.\n\nIn a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.\n\nBoth schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.\n\nThere can be at most 256 such reservations. This may get increased in the future, but not reduced.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimConsumerReference"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimConsumerReference"
},
"type": [
"array",
diff --git a/master/resourceclaimtemplate-resource-v1beta2.json b/master/resourceclaimtemplate-resource-v1beta2.json
new file mode 100644
index 0000000000..9e3e063a3a
--- /dev/null
+++ b/master/resourceclaimtemplate-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "ResourceClaimTemplate is used to produce ResourceClaim objects.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplate"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
+ "description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplate",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimtemplate.json b/master/resourceclaimtemplate.json
index bc95f82cb1..5966e6949a 100644
--- a/master/resourceclaimtemplate.json
+++ b/master/resourceclaimtemplate.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplateSpec",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplateSpec",
"description": "Describes the ResourceClaim that is to be generated.\n\nThis field is immutable. A ResourceClaim will get created by the control plane for a Pod when needed and then not get updated anymore."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplate",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceclaimtemplatelist-resource-v1beta2.json b/master/resourceclaimtemplatelist-resource-v1beta2.json
new file mode 100644
index 0000000000..1bc7b60803
--- /dev/null
+++ b/master/resourceclaimtemplatelist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceClaimTemplateList is a collection of claim templates.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource claim templates.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceClaimTemplateList"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceClaimTemplateList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimtemplatelist.json b/master/resourceclaimtemplatelist.json
index 62bbbddbe6..331c02045e 100644
--- a/master/resourceclaimtemplatelist.json
+++ b/master/resourceclaimtemplatelist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource claim templates.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimTemplate"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimTemplate"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceClaimTemplateList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceclaimtemplatespec-resource-v1beta2.json b/master/resourceclaimtemplatespec-resource-v1beta2.json
new file mode 100644
index 0000000000..cb819a8792
--- /dev/null
+++ b/master/resourceclaimtemplatespec-resource-v1beta2.json
@@ -0,0 +1,18 @@
+{
+ "description": "ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.",
+ "properties": {
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
+ },
+ "spec": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
+ "description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceclaimtemplatespec.json b/master/resourceclaimtemplatespec.json
index c737ddc544..cb819a8792 100644
--- a/master/resourceclaimtemplatespec.json
+++ b/master/resourceclaimtemplatespec.json
@@ -6,7 +6,7 @@
"description": "ObjectMeta may contain labels and annotations that will be copied into the ResourceClaim when creating it. No other fields are allowed and will be rejected during validation."
},
"spec": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceClaimSpec",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceClaimSpec",
"description": "Spec for the ResourceClaim. The entire content is copied unchanged into the ResourceClaim that gets created from this template. The same fields as in a ResourceClaim are also valid here."
}
},
diff --git a/master/resourcepool-resource-v1beta2.json b/master/resourcepool-resource-v1beta2.json
new file mode 100644
index 0000000000..c85bd4c5ed
--- /dev/null
+++ b/master/resourcepool-resource-v1beta2.json
@@ -0,0 +1,35 @@
+{
+ "description": "ResourcePool describes the pool that ResourceSlices belong to.",
+ "properties": {
+ "generation": {
+ "description": "Generation tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part of that pool. Consumers of ResourceSlices should only consider resources from the pool with the highest generation number. The generation may be reset by drivers, which should be fine for consumers, assuming that all ResourceSlices in a pool are updated to match or deleted.\n\nCombined with ResourceSliceCount, this mechanism enables consumers to detect pools which are comprised of multiple ResourceSlices and are in an incomplete state.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "name": {
+ "description": "Name is used to identify the pool. For node-local devices, this is often the node name, but this is not required.\n\nIt must not be longer than 253 characters and must consist of one or more DNS sub-domains separated by slashes. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "resourceSliceCount": {
+ "description": "ResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero.\n\nConsumers can use this to check whether they have seen all ResourceSlices belonging to the same pool.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name",
+ "generation",
+ "resourceSliceCount"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceslice-resource-v1beta2.json b/master/resourceslice-resource-v1beta2.json
new file mode 100644
index 0000000000..5977f368d0
--- /dev/null
+++ b/master/resourceslice-resource-v1beta2.json
@@ -0,0 +1,45 @@
+{
+ "description": "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.\n\nAt 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>.\n\nWhenever 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.\n\nWhen 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.\n\nFor 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.\n\nThis is an alpha type and requires enabling the DynamicResourceAllocation feature gate.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSlice"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta",
+ "description": "Standard object metadata"
+ },
+ "spec": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
+ "description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
+ }
+ },
+ "required": [
+ "spec"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSlice",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceslice.json b/master/resourceslice.json
index 2a39595c61..c7b1ae4f65 100644
--- a/master/resourceslice.json
+++ b/master/resourceslice.json
@@ -23,7 +23,7 @@
"description": "Standard object metadata"
},
"spec": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSliceSpec",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSliceSpec",
"description": "Contains the information published by the driver.\n\nChanging the spec automatically increments the metadata.generation number."
}
},
@@ -35,7 +35,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSlice",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceslicelist-resource-v1beta2.json b/master/resourceslicelist-resource-v1beta2.json
new file mode 100644
index 0000000000..081293f5e9
--- /dev/null
+++ b/master/resourceslicelist-resource-v1beta2.json
@@ -0,0 +1,51 @@
+{
+ "description": "ResourceSliceList is a collection of ResourceSlices.",
+ "properties": {
+ "apiVersion": {
+ "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "resource.k8s.io/v1beta2"
+ ]
+ },
+ "items": {
+ "description": "Items is the list of resource ResourceSlices.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "kind": {
+ "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "ResourceSliceList"
+ ]
+ },
+ "metadata": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta",
+ "description": "Standard list metadata"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object",
+ "x-kubernetes-group-version-kind": [
+ {
+ "group": "resource.k8s.io",
+ "kind": "ResourceSliceList",
+ "version": "v1beta2"
+ }
+ ],
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceslicelist.json b/master/resourceslicelist.json
index f4dce5239d..cf58da5b58 100644
--- a/master/resourceslicelist.json
+++ b/master/resourceslicelist.json
@@ -11,7 +11,7 @@
"items": {
"description": "Items is the list of resource ResourceSlices.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourceSlice"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourceSlice"
},
"type": [
"array",
@@ -41,7 +41,7 @@
{
"group": "resource.k8s.io",
"kind": "ResourceSliceList",
- "version": "v1beta1"
+ "version": "v1beta2"
}
],
"$schema": "http://json-schema.org/schema#"
diff --git a/master/resourceslicespec-resource-v1beta2.json b/master/resourceslicespec-resource-v1beta2.json
new file mode 100644
index 0000000000..f2d27f5719
--- /dev/null
+++ b/master/resourceslicespec-resource-v1beta2.json
@@ -0,0 +1,69 @@
+{
+ "description": "ResourceSliceSpec contains the information published by the driver in one ResourceSlice.",
+ "properties": {
+ "allNodes": {
+ "description": "AllNodes indicates that all nodes have access to the resources in the pool.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "devices": {
+ "description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ },
+ "driver": {
+ "description": "Driver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name.\n\nMust be a DNS subdomain and should end with a DNS domain owned by the vendor of the driver. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeName": {
+ "description": "NodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node.\n\nThis field can be used to limit access from nodes to ResourceSlices with the same node name. It also indicates to autoscalers that adding new nodes of the same type as some old node might also make new resources available.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set. This field is immutable.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "nodeSelector": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.core.v1.NodeSelector",
+ "description": "NodeSelector defines which nodes have access to the resources in the pool, when that pool is not limited to a single node.\n\nMust use exactly one term.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set."
+ },
+ "perDeviceNodeSelection": {
+ "description": "PerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice must specify this individually.\n\nExactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "pool": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
+ "description": "Pool describes the pool that this ResourceSlice belongs to."
+ },
+ "sharedCounters": {
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
+ "items": {
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
+ },
+ "type": [
+ "array",
+ "null"
+ ],
+ "x-kubernetes-list-type": "atomic"
+ }
+ },
+ "required": [
+ "driver",
+ "pool"
+ ],
+ "type": "object",
+ "$schema": "http://json-schema.org/schema#"
+}
\ No newline at end of file
diff --git a/master/resourceslicespec.json b/master/resourceslicespec.json
index d66681e316..f2d27f5719 100644
--- a/master/resourceslicespec.json
+++ b/master/resourceslicespec.json
@@ -11,7 +11,7 @@
"devices": {
"description": "Devices lists some or all of the devices in this pool.\n\nMust not have more than 128 entries.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.Device"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.Device"
},
"type": [
"array",
@@ -45,13 +45,13 @@
]
},
"pool": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.ResourcePool",
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.ResourcePool",
"description": "Pool describes the pool that this ResourceSlice belongs to."
},
"sharedCounters": {
- "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of SharedCounters is 32.",
+ "description": "SharedCounters defines a list of counter sets, each of which has a name and a list of counters available.\n\nThe names of the SharedCounters must be unique in the ResourceSlice.\n\nThe maximum number of counters in all sets is 32.",
"items": {
- "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta1.CounterSet"
+ "$ref": "https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/master/_definitions.json#/definitions/io.k8s.api.resource.v1beta2.CounterSet"
},
"type": [
"array",
diff --git a/master/watchevent-meta-v1.json b/master/watchevent-meta-v1.json
index b38bf62bfe..69011f6137 100644
--- a/master/watchevent-meta-v1.json
+++ b/master/watchevent-meta-v1.json
@@ -288,6 +288,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
diff --git a/master/watchevent.json b/master/watchevent.json
index b38bf62bfe..69011f6137 100644
--- a/master/watchevent.json
+++ b/master/watchevent.json
@@ -288,6 +288,11 @@
"kind": "WatchEvent",
"version": "v1beta1"
},
+ {
+ "group": "resource.k8s.io",
+ "kind": "WatchEvent",
+ "version": "v1beta2"
+ },
{
"group": "scheduling.k8s.io",
"kind": "WatchEvent",
--
GitLab