github/kubernetes
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

DRA: new API for 1.31

Browse Source 
This is a complete revamp of the original API. Some of the key
differences:
- refocused on structured parameters and allocating devices
- support for constraints across devices
- support for allocating "all" or a fixed amount
  of similar devices in a single request
- no class for ResourceClaims, instead individual
  device requests are associated with a mandatory
  DeviceClass

For the sake of simplicity, optional basic types (ints, strings) where the null
value is the default are represented as values in the API types. This makes Go
code simpler because it doesn't have to check for nil (consumers) and values
can be set directly (producers). The effect is that in protobuf, these fields
always get encoded because `opt` only has an effect for pointers.

The roundtrip test data for v1.29.0 and v1.30.0 changes because of the new
"request" field. This is considered acceptable because the entire `claims`
field in the pod spec is still alpha.

The implementation is complete enough to bring up the apiserver.
Adapting other components follows.
This commit is contained in:
Patrick Ohly
2024-06-18 17:47:29 +02:00
parent bcececadfb
commit 91d7882e86
306 changed files with 16480 additions and 26466 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
api/api-rules/violation_exceptions.list
View File

@@ -52,13 +52,10 @@ API rule violation: names_match,k8s.io/api/core/v1,VolumeSource,CephFS
API rule violation: names_match,k8s.io/api/core/v1,VolumeSource,StorageOS
API rule violation: names_match,k8s.io/api/networking/v1alpha1,ServiceCIDRSpec,CIDRs
API rule violation: names_match,k8s.io/api/networking/v1beta1,ServiceCIDRSpec,CIDRs
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,BoolValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,IntSliceValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,IntValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,QuantityValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,StringSliceValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,StringValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,NamedResourcesAttributeValue,VersionValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,DeviceAttribute,BoolValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,DeviceAttribute,IntValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,DeviceAttribute,StringValue
API rule violation: names_match,k8s.io/api/resource/v1alpha3,DeviceAttribute,VersionValue
API rule violation: names_match,k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1,JSONSchemaProps,Ref
API rule violation: names_match,k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1,JSONSchemaProps,Schema
API rule violation: names_match,k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1,JSONSchemaProps,XEmbeddedResource

80
api/discovery/aggregated_v2.json
View File

@@ -1891,6 +1891,26 @@
{
"freshness": "Current",
"resources": [
{
"resource": "deviceclasses",
"responseKind": {
"group": "",
"kind": "DeviceClass",
"version": ""
},
"scope": "Cluster",
"singularResource": "deviceclass",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "podschedulingcontexts",
"responseKind": {
@@ -1926,26 +1946,6 @@
"watch"
]
},
{
"resource": "resourceclaimparameters",
"responseKind": {
"group": "",
"kind": "ResourceClaimParameters",
"version": ""
},
"scope": "Namespaced",
"singularResource": "resourceclaimparameters",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceclaims",
"responseKind": {
@@ -2001,46 +2001,6 @@
"watch"
]
},
{
"resource": "resourceclasses",
"responseKind": {
"group": "",
"kind": "ResourceClass",
"version": ""
},
"scope": "Cluster",
"singularResource": "resourceclass",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceclassparameters",
"responseKind": {
"group": "",
"kind": "ResourceClassParameters",
"version": ""
},
"scope": "Namespaced",
"singularResource": "resourceclassparameters",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceslices",
"responseKind": {

80
api/discovery/aggregated_v2beta1.json
View File

@@ -1891,6 +1891,26 @@
{
"freshness": "Current",
"resources": [
{
"resource": "deviceclasses",
"responseKind": {
"group": "",
"kind": "DeviceClass",
"version": ""
},
"scope": "Cluster",
"singularResource": "deviceclass",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "podschedulingcontexts",
"responseKind": {
@@ -1926,26 +1946,6 @@
"watch"
]
},
{
"resource": "resourceclaimparameters",
"responseKind": {
"group": "",
"kind": "ResourceClaimParameters",
"version": ""
},
"scope": "Namespaced",
"singularResource": "resourceclaimparameters",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceclaims",
"responseKind": {
@@ -2001,46 +2001,6 @@
"watch"
]
},
{
"resource": "resourceclasses",
"responseKind": {
"group": "",
"kind": "ResourceClass",
"version": ""
},
"scope": "Cluster",
"singularResource": "resourceclass",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceclassparameters",
"responseKind": {
"group": "",
"kind": "ResourceClassParameters",
"version": ""
},
"scope": "Namespaced",
"singularResource": "resourceclassparameters",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"resource": "resourceslices",
"responseKind": {

68
api/discovery/apis__resource.k8s.io__v1alpha3.json
View File

@@ -3,6 +3,23 @@
"groupVersion": "resource.k8s.io/v1alpha3",
"kind": "APIResourceList",
"resources": [
{
"kind": "DeviceClass",
"name": "deviceclasses",
"namespaced": false,
"singularName": "deviceclass",
"storageVersionHash": "12soGlw2WzE=",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"kind": "PodSchedulingContext",
"name": "podschedulingcontexts",
@@ -31,23 +48,6 @@
"update"
]
},
{
"kind": "ResourceClaimParameters",
"name": "resourceclaimparameters",
"namespaced": true,
"singularName": "resourceclaimparameters",
"storageVersionHash": "42WVd9cucrU=",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"kind": "ResourceClaim",
"name": "resourceclaims",
@@ -93,40 +93,6 @@
"watch"
]
},
{
"kind": "ResourceClass",
"name": "resourceclasses",
"namespaced": false,
"singularName": "resourceclass",
"storageVersionHash": "gv35DluSP3c=",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"kind": "ResourceClassParameters",
"name": "resourceclassparameters",
"namespaced": true,
"singularName": "resourceclassparameters",
"storageVersionHash": "369PrU9Yi/E=",
"verbs": [
"create",
"delete",
"deletecollection",
"get",
"list",
"patch",
"update",
"watch"
]
},
{
"kind": "ResourceSlice",
"name": "resourceslices",

3809
api/openapi-spec/swagger.json generated
View File

File diff suppressed because it is too large Load Diff

9
api/openapi-spec/v3/api__v1_openapi.json
View File

@@ -6560,6 +6560,10 @@
"default": "",
"description": "Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.",
"type": "string"
},
"request": {
"description": "Request is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.",
"type": "string"
}
},
"required": [
@@ -9407,11 +9411,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__admissionregistration.k8s.io__v1_openapi.json
View File

@@ -1951,11 +1951,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__admissionregistration.k8s.io__v1alpha1_openapi.json
View File

@@ -1463,11 +1463,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__admissionregistration.k8s.io__v1beta1_openapi.json
View File

@@ -1465,11 +1465,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__apiextensions.k8s.io__v1_openapi.json
View File

@@ -1617,11 +1617,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__apiregistration.k8s.io__v1_openapi.json
View File

@@ -750,11 +750,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

9
api/openapi-spec/v3/apis__apps__v1_openapi.json
View File

@@ -4300,6 +4300,10 @@
"default": "",
"description": "Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.",
"type": "string"
},
"request": {
"description": "Request is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.",
"type": "string"
}
},
"required": [
@@ -6167,11 +6171,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__autoscaling__v1_openapi.json
View File

@@ -943,11 +943,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__autoscaling__v2_openapi.json
View File

@@ -1652,11 +1652,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

9
api/openapi-spec/v3/apis__batch__v1_openapi.json
View File

@@ -3504,6 +3504,10 @@
"default": "",
"description": "Name must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.",
"type": "string"
},
"request": {
"description": "Request is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.",
"type": "string"
}
},
"required": [
@@ -5371,11 +5375,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__certificates.k8s.io__v1_openapi.json
View File

@@ -979,11 +979,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__certificates.k8s.io__v1alpha1_openapi.json
View File

@@ -855,11 +855,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__coordination.k8s.io__v1_openapi.json
View File

@@ -875,11 +875,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__discovery.k8s.io__v1_openapi.json
View File

@@ -1033,11 +1033,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__events.k8s.io__v1_openapi.json
View File

@@ -993,11 +993,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__flowcontrol.apiserver.k8s.io__v1_openapi.json
View File

@@ -1479,11 +1479,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__flowcontrol.apiserver.k8s.io__v1beta3_openapi.json
View File

@@ -1480,11 +1480,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__internal.apiserver.k8s.io__v1alpha1_openapi.json
View File

@@ -969,11 +969,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__networking.k8s.io__v1_openapi.json
View File

@@ -1608,11 +1608,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__networking.k8s.io__v1beta1_openapi.json
View File

@@ -1055,11 +1055,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__node.k8s.io__v1_openapi.json
View File

@@ -928,11 +928,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__policy__v1_openapi.json
View File

@@ -1047,11 +1047,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__rbac.authorization.k8s.io__v1_openapi.json
View File

@@ -1320,11 +1320,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

6364
api/openapi-spec/v3/apis__resource.k8s.io__v1alpha3_openapi.json
View File

File diff suppressed because it is too large Load Diff

5
api/openapi-spec/v3/apis__scheduling.k8s.io__v1_openapi.json
View File

@@ -846,11 +846,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__storage.k8s.io__v1_openapi.json
View File

@@ -2765,11 +2765,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__storage.k8s.io__v1alpha1_openapi.json
View File

@@ -841,11 +841,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},

5
api/openapi-spec/v3/apis__storagemigration.k8s.io__v1alpha1_openapi.json
View File

@@ -953,11 +953,6 @@
"group": "",
"kind": "Status",
"version": "v1"
},
{
"group": "resource.k8s.io",
"kind": "Status",
"version": "v1alpha3"
}
]
},