Skip to content

Commit e5850bc

Browse files
authored
Merge pull request #50464 from my-git9/npa-19106
[zh-cn] sync device-class-v1beta1.md
2 parents 0ab8d5b + 6acacb4 commit e5850bc

File tree

1 file changed

+32
-72
lines changed

1 file changed

+32
-72
lines changed

content/zh-cn/docs/reference/kubernetes-api/extend-resources/device-class-v1beta1.md

Lines changed: 32 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,14 @@ auto_generated: true
2121
-->
2222

2323
<!--
24-
The file was copied and updated manually from the v1alpha3 API.
24+
The file is auto-generated from the Go source code of the component using a generic
25+
[generator](https://github.com/kubernetes-sigs/reference-docs/). To learn how
26+
to generate the reference documentation, please read
27+
[Contributing to the reference documentation](/docs/contribute/generate-ref-docs/).
28+
To update the reference content, please follow the
29+
[Contributing upstream](/docs/contribute/generate-ref-docs/contribute-upstream/)
30+
guide. You can file document formatting bugs against the
31+
[reference-docs](https://github.com/kubernetes-sigs/reference-docs/) project.
2532
-->
2633

2734
`apiVersion: resource.k8s.io/v1beta1`
@@ -145,6 +152,8 @@ DeviceClassSpec 在 DeviceClass 中用于定义可被分配的资源以及如何
145152
146153
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.
147154
155+
The length of the raw data must be smaller or equal to 10 Ki.
156+
148157
<a name="RawExtension"></a>
149158
*RawExtension is used to hold extensions in external versions.
150159
@@ -156,6 +165,8 @@ DeviceClassSpec 在 DeviceClass 中用于定义可被分配的资源以及如何
156165
parameters 可以包含任意数据。处理校验和版本控制是驱动开发者的责任。
157166
通常这包括自我标识和版本信息(对 Kubernetes 而言即 "kind" + "apiVersion"),并在不同版本之间进行转换。
158167

168+
原始数据的长度必须小于或等于 10 Ki。
169+
159170
<a name="RawExtension"></a>
160171
**RawExtension 用于以外部版本来保存扩展数据。**
161172

@@ -323,77 +334,10 @@ DeviceClassSpec 在 DeviceClass 中用于定义可被分配的资源以及如何
323334
cel.bind(dra, device.attributes["dra.example.com"], dra.someBool && dra.anotherBool)
324335
```
325336
326-
<!--
327-
- **suitableNodes** (NodeSelector)
328-
329-
Only nodes matching the selector will be considered by the scheduler when trying to find a Node that fits a Pod when that Pod uses a claim that has not been allocated yet *and* that claim gets allocated through a control plane controller. It is ignored when the claim does not use a control plane controller for allocation.
330-
331-
Setting this field is optional. If unset, all Nodes are candidates.
332-
333-
This is an alpha field and requires enabling the DRAControlPlaneController feature gate.
334-
335-
<a name="NodeSelector"></a>
336-
*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.*
337-
-->
338-
- **suitableNodes** (NodeSelector)
339-
340-
当 Pod 使用还未分配的申领**且**该申领通过控制平面控制器分配时,如果调度器在尝试查找适合 Pod 的节点,
341-
将仅考虑与选择算符匹配的节点。当申领不使用控制平面控制器进行分配时,此字段将被忽略。
342-
343-
设置此字段是可选的,如果不设置,则所有节点都是候选者。
344-
345-
这是一个 Alpha 字段,需要启用 DRAControlPlaneController 特性门控。
346-
347-
<a name="NodeSelector"></a>
348-
**节点选择算符表示针对一组节点执行一个或多个标签查询的结果的并集;
349-
也就是说,它表示由节点选择算符条件表示的选择算符的逻辑或计算结果。**
350-
351-
<!--
352-
- **suitableNodes.nodeSelectorTerms** ([]NodeSelectorTerm), required
353-
354-
*Atomic: will be replaced during a merge*
355-
356-
Required. A list of node selector terms. The terms are ORed.
357-
358-
<a name="NodeSelectorTerm"></a>
359-
*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.*
360-
-->
361-
362-
- **suitableNodes.nodeSelectorTerms** ([]NodeSelectorTerm),必需
363-
364-
**原子:将在合并期间被替换**
365-
366-
必需。节点选择算符条件的列表。这些条件会按逻辑或的关系来计算。
367-
368-
<a name="NodeSelectorTerm"></a>
369-
**Null 或空的节点选择算符条件不会与任何对象匹配。这些条件会按逻辑与的关系来计算。
370-
TopologySelectorTerm 类别实现了 NodeSelectorTerm 的子集。**
371-
372-
<!--
373-
- **suitableNodes.nodeSelectorTerms.matchExpressions** ([]<a href="{{< ref "../common-definitions/node-selector-requirement#NodeSelectorRequirement" >}}">NodeSelectorRequirement</a>)
374-
375-
*Atomic: will be replaced during a merge*
376-
377-
A list of node selector requirements by node's labels.
378-
379-
- **suitableNodes.nodeSelectorTerms.matchFields** ([]<a href="{{< ref "../common-definitions/node-selector-requirement#NodeSelectorRequirement" >}}">NodeSelectorRequirement</a>)
380-
381-
*Atomic: will be replaced during a merge*
382-
383-
A list of node selector requirements by node's fields.
384-
-->
385-
386-
- **suitableNodes.nodeSelectorTerms.matchExpressions** ([]<a href="{{< ref "../common-definitions/node-selector-requirement#NodeSelectorRequirement" >}}">NodeSelectorRequirement</a>)
387-
388-
**原子:将在合并期间被替换**
389-
390-
基于节点标签所设置的节点选择算符要求的列表。
391-
392-
- **suitableNodes.nodeSelectorTerms.matchFields** ([]<a href="{{< ref "../common-definitions/node-selector-requirement#NodeSelectorRequirement" >}}">NodeSelectorRequirement</a>)
393-
394-
**原子:将在合并期间被替换**
395-
396-
基于节点字段所设置的节点选择算符要求的列表。
337+
<!--
338+
The length of the expression must be smaller or equal to 10 Ki. The cost of evaluating it is also limited based on the estimated number of logical steps.
339+
-->
340+
表达式的长度必须小于或等于 10 Ki。根据估计的逻辑步骤数,其评估成本也受到限制。
397341
398342
## DeviceClassList {#DeviceClassList}
399343
@@ -842,6 +786,10 @@ DELETE /apis/resource.k8s.io/v1beta1/deviceclasses/{name}
842786
843787
<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
844788
789+
- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
790+
791+
<a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
792+
845793
- **pretty** (*in query*): string
846794
847795
<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@@ -864,6 +812,10 @@ DELETE /apis/resource.k8s.io/v1beta1/deviceclasses/{name}
864812
865813
<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
866814
815+
- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
816+
817+
<a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
818+
867819
- **pretty** (**查询参数**): string
868820
869821
<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@@ -919,6 +871,10 @@ DELETE /apis/resource.k8s.io/v1beta1/deviceclasses
919871
920872
<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
921873
874+
- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
875+
876+
<a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
877+
922878
- **labelSelector** (*in query*): string
923879
924880
<a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
@@ -969,6 +925,10 @@ DELETE /apis/resource.k8s.io/v1beta1/deviceclasses
969925
970926
<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
971927
928+
- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
929+
930+
<a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
931+
972932
- **labelSelector** (**查询参数**): string
973933
974934
<a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>

0 commit comments

Comments
 (0)