Skip to content

Commit 69eda55

Browse files
CaesarsageCaesarsage
committed
Update Config API reference for v1.36.0
1 parent d4f28e3 commit 69eda55

15 files changed

Lines changed: 188 additions & 46 deletions

‎content/en/docs/reference/config-api/apiserver-admission.v1.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ auto_generated: true
6060
<tbody>
6161

6262

63-
<tr><td><code>uid</code> <B>[Required]</B><br/>
63+
<tr><td><code>uid</code><br/>
6464
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/types#UID"><code>k8s.io/apimachinery/pkg/types.UID</code></a>
6565
</td>
6666
<td>
@@ -70,14 +70,14 @@ The UID is meant to track the round trip (request/response) between the KAS and
7070
It is suitable for correlating log entries between the webhook and apiserver, for either auditing or debugging.</p>
7171
</td>
7272
</tr>
73-
<tr><td><code>kind</code> <B>[Required]</B><br/>
73+
<tr><td><code>kind</code><br/>
7474
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionKind"><code>meta/v1.GroupVersionKind</code></a>
7575
</td>
7676
<td>
7777
<p>kind is the fully-qualified type of object being submitted (for example, v1.Pod or autoscaling.v1.Scale)</p>
7878
</td>
7979
</tr>
80-
<tr><td><code>resource</code> <B>[Required]</B><br/>
80+
<tr><td><code>resource</code><br/>
8181
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#GroupVersionResource"><code>meta/v1.GroupVersionResource</code></a>
8282
</td>
8383
<td>
@@ -143,16 +143,16 @@ rely on the server to generate the name. If that is the case, this field will c
143143
<p>namespace is the namespace associated with the request (if any).</p>
144144
</td>
145145
</tr>
146-
<tr><td><code>operation</code> <B>[Required]</B><br/>
146+
<tr><td><code>operation</code><br/>
147147
<a href="#admission-k8s-io-v1-Operation"><code>Operation</code></a>
148148
</td>
149149
<td>
150150
<p>operation is the operation being performed. This may be different than the operation
151151
requested. e.g. a patch can result in either a CREATE or UPDATE Operation.</p>
152152
</td>
153153
</tr>
154-
<tr><td><code>userInfo</code> <B>[Required]</B><br/>
155-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
154+
<tr><td><code>userInfo</code><br/>
155+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
156156
</td>
157157
<td>
158158
<p>userInfo is information about the requesting user</p>
@@ -210,23 +210,23 @@ Operation might be a CREATE, in which case the Options will a
210210
<tbody>
211211

212212

213-
<tr><td><code>uid</code> <B>[Required]</B><br/>
213+
<tr><td><code>uid</code><br/>
214214
<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/types#UID"><code>k8s.io/apimachinery/pkg/types.UID</code></a>
215215
</td>
216216
<td>
217217
<p>uid is an identifier for the individual request/response.
218218
This must be copied over from the corresponding AdmissionRequest.</p>
219219
</td>
220220
</tr>
221-
<tr><td><code>allowed</code> <B>[Required]</B><br/>
221+
<tr><td><code>allowed</code><br/>
222222
<code>bool</code>
223223
</td>
224224
<td>
225225
<p>allowed indicates whether or not the admission request was permitted.</p>
226226
</td>
227227
</tr>
228228
<tr><td><code>status</code><br/>
229-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#status-v1-meta"><code>meta/v1.Status</code></a>
229+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#status-v1-meta"><code>meta/v1.Status</code></a>
230230
</td>
231231
<td>
232232
<p>status is the result contains extra details into why an admission request was denied.

‎content/en/docs/reference/config-api/apiserver-audit.v1.md‎

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -71,14 +71,14 @@ For non-resource requests, this is the lower-cased HTTP method.</p>
7171
</td>
7272
</tr>
7373
<tr><td><code>user</code> <B>[Required]</B><br/>
74-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
74+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
7575
</td>
7676
<td>
7777
<p>Authenticated user information.</p>
7878
</td>
7979
</tr>
8080
<tr><td><code>impersonatedUser</code><br/>
81-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
81+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#userinfo-v1-authentication-k8s-io"><code>authentication/v1.UserInfo</code></a>
8282
</td>
8383
<td>
8484
<p>Impersonated user information.</p>
@@ -123,7 +123,7 @@ Does not apply for List-type requests, or non-resource requests.</p>
123123
</td>
124124
</tr>
125125
<tr><td><code>responseStatus</code><br/>
126-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#status-v1-meta"><code>meta/v1.Status</code></a>
126+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#status-v1-meta"><code>meta/v1.Status</code></a>
127127
</td>
128128
<td>
129129
<p>The response status, populated even when the ResponseObject is not a Status type.
@@ -151,14 +151,14 @@ at Response Level.</p>
151151
</td>
152152
</tr>
153153
<tr><td><code>requestReceivedTimestamp</code><br/>
154-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
154+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
155155
</td>
156156
<td>
157157
<p>Time the request reached the apiserver.</p>
158158
</td>
159159
</tr>
160160
<tr><td><code>stageTimestamp</code><br/>
161-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
161+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
162162
</td>
163163
<td>
164164
<p>Time the request reached current audit stage.</p>
@@ -195,7 +195,7 @@ should be short. Annotations are included in the Metadata level.</p>
195195

196196

197197
<tr><td><code>metadata</code><br/>
198-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
198+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
199199
</td>
200200
<td>
201201
<span class="text-muted">No description provided.</span></td>
@@ -230,7 +230,7 @@ categories are logged.</p>
230230

231231

232232
<tr><td><code>metadata</code><br/>
233-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
233+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
234234
</td>
235235
<td>
236236
<p>ObjectMeta is included for interoperability with API infrastructure.</p>
@@ -285,7 +285,7 @@ in a rule will override the global default.</p>
285285

286286

287287
<tr><td><code>metadata</code><br/>
288-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
288+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
289289
</td>
290290
<td>
291291
<span class="text-muted">No description provided.</span></td>
@@ -345,7 +345,8 @@ the ImpersonatedUser associated with this audit event. It is only set when cons
345345
</td>
346346
<td>
347347
<p>Group is the name of the API group that contains the resources.
348-
The empty string represents the core API group.</p>
348+
The empty string represents the core API group.
349+
<code>*</code> matches all groups</p>
349350
</td>
350351
</tr>
351352
<tr><td><code>resources</code><br/>

‎content/en/docs/reference/config-api/apiserver-config.v1alpha1.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1018,6 +1018,13 @@ Must be absent/empty if TCPTransport.URL is prefixed with http://
10181018
Must be configured if TCPTransport.URL is prefixed with https://</p>
10191019
</td>
10201020
</tr>
1021+
<tr><td><code>tlsServerName</code><br/>
1022+
<code>string</code>
1023+
</td>
1024+
<td>
1025+
<p>tlsServerName is used to check server certificate. If tlsServerName is empty, the hostname used to contact the server is used.</p>
1026+
</td>
1027+
</tr>
10211028
</tbody>
10221029
</table>
10231030

‎content/en/docs/reference/config-api/apiserver-config.v1beta1.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -951,6 +951,13 @@ Must be absent/empty if TCPTransport.URL is prefixed with http://
951951
Must be configured if TCPTransport.URL is prefixed with https://</p>
952952
</td>
953953
</tr>
954+
<tr><td><code>tlsServerName</code><br/>
955+
<code>string</code>
956+
</td>
957+
<td>
958+
<p>tlsServerName is used to check server certificate. If tlsServerName is empty, the hostname used to contact the server is used.</p>
959+
</td>
960+
</tr>
954961
</tbody>
955962
</table>
956963

‎content/en/docs/reference/config-api/apiserver-webhookadmission.v1.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,19 @@ auto_generated: true
3535
<p>KubeConfigFile is the path to the kubeconfig file.</p>
3636
</td>
3737
</tr>
38+
<tr><td><code>staticManifestsDir</code><br/>
39+
<code>string</code>
40+
</td>
41+
<td>
42+
<p>StaticManifestsDir is the path to a directory containing static webhook
43+
configurations to be loaded at startup. Files with extensions .yaml,
44+
.yml, and .json are read. Only admissionregistration.k8s.io/v1
45+
ValidatingWebhookConfiguration and MutatingWebhookConfiguration
46+
resources are supported.
47+
Using this field requires the ManifestBasedAdmissionControlConfig
48+
feature gate to be enabled.</p>
49+
</td>
50+
</tr>
3851
</tbody>
3952
</table>
4053

‎content/en/docs/reference/config-api/client-authentication.v1.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@ itself should at least be protected via file permissions.</p>
205205

206206

207207
<tr><td><code>expirationTimestamp</code><br/>
208-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#time-v1-meta"><code>meta/v1.Time</code></a>
208+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#time-v1-meta"><code>meta/v1.Time</code></a>
209209
</td>
210210
<td>
211211
<p>ExpirationTimestamp indicates a time when the provided credentials expire.</p>

‎content/en/docs/reference/config-api/client-authentication.v1beta1.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@ itself should at least be protected via file permissions.</p>
205205

206206

207207
<tr><td><code>expirationTimestamp</code><br/>
208-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#time-v1-meta"><code>meta/v1.Time</code></a>
208+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#time-v1-meta"><code>meta/v1.Time</code></a>
209209
</td>
210210
<td>
211211
<p>ExpirationTimestamp indicates a time when the provided credentials expire.</p>

‎content/en/docs/reference/config-api/imagepolicy.v1alpha1.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,14 @@ auto_generated: true
2828

2929

3030
<tr><td><code>metadata</code><br/>
31-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
31+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
3232
</td>
3333
<td>
3434
<p>Standard object's metadata.
3535
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata</p>
3636
Refer to the Kubernetes API documentation for the fields of the <code>metadata</code> field.</td>
3737
</tr>
38-
<tr><td><code>spec</code> <B>[Required]</B><br/>
38+
<tr><td><code>spec</code><br/>
3939
<a href="#imagepolicy-k8s-io-v1alpha1-ImageReviewSpec"><code>ImageReviewSpec</code></a>
4040
</td>
4141
<td>
@@ -136,7 +136,7 @@ It is up to each webhook backend to determine how to interpret these annotations
136136
<tbody>
137137

138138

139-
<tr><td><code>allowed</code> <B>[Required]</B><br/>
139+
<tr><td><code>allowed</code><br/>
140140
<code>bool</code>
141141
</td>
142142
<td>

‎content/en/docs/reference/config-api/kube-controller-manager-config.v1alpha1.md‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,15 @@ during leader election cycles.</p>
220220
concurrently synchronizing nodes</p>
221221
</td>
222222
</tr>
223+
<tr><td><code>ConcurrentNodeStatusUpdates</code> <B>[Required]</B><br/>
224+
<code>int32</code>
225+
</td>
226+
<td>
227+
<p>ConcurrentNodeStatusUpdates is the number of workers
228+
concurrently updating node statuses.
229+
If unspecified or 0, ConcurrentNodeSyncs is used instead</p>
230+
</td>
231+
</tr>
223232
</tbody>
224233
</table>
225234

@@ -923,6 +932,13 @@ ValidatingAdmissionPolicyStatusController related features.</p>
923932
<p>DeviceTaintEvictionControllerConfiguration contains elements configuring the device taint eviction controller.</p>
924933
</td>
925934
</tr>
935+
<tr><td><code>ResourceClaimController</code> <B>[Required]</B><br/>
936+
<a href="#kubecontrollermanager-config-k8s-io-v1alpha1-ResourceClaimControllerConfiguration"><code>ResourceClaimControllerConfiguration</code></a>
937+
</td>
938+
<td>
939+
<p>ResourceClaimControllerConfiguration contains elements configuring the resource claim controller.</p>
940+
</td>
941+
</tr>
926942
</tbody>
927943
</table>
928944

@@ -1923,6 +1939,34 @@ management, but more CPU (and network) load.</p>
19231939
</tbody>
19241940
</table>
19251941

1942+
## `ResourceClaimControllerConfiguration` {#kubecontrollermanager-config-k8s-io-v1alpha1-ResourceClaimControllerConfiguration}
1943+
1944+
1945+
**Appears in:**
1946+
1947+
- [KubeControllerManagerConfiguration](#kubecontrollermanager-config-k8s-io-v1alpha1-KubeControllerManagerConfiguration)
1948+
1949+
1950+
<p>ResourceClaimControllerConfiguration contains elements configuring the resource claim controller.</p>
1951+
1952+
1953+
<table class="table">
1954+
<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
1955+
<tbody>
1956+
1957+
1958+
<tr><td><code>ConcurrentSyncs</code> <B>[Required]</B><br/>
1959+
<code>int32</code>
1960+
</td>
1961+
<td>
1962+
<p>ConcurrentSyncs is the number of operations (deleting a pod, updating a ResourcClaim status, etc.)
1963+
that will be done concurrently. Larger number = processing, but more CPU (and network) load.</p>
1964+
<p>The default is 50.</p>
1965+
</td>
1966+
</tr>
1967+
</tbody>
1968+
</table>
1969+
19261970
## `ResourceQuotaControllerConfiguration` {#kubecontrollermanager-config-k8s-io-v1alpha1-ResourceQuotaControllerConfiguration}
19271971

19281972

‎content/en/docs/reference/config-api/kube-scheduler-config.v1.md‎

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -482,7 +482,7 @@ Defaults to false.</p>
482482

483483

484484
<tr><td><code>addedAffinity</code><br/>
485-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#nodeaffinity-v1-core"><code>core/v1.NodeAffinity</code></a>
485+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#nodeaffinity-v1-core"><code>core/v1.NodeAffinity</code></a>
486486
</td>
487487
<td>
488488
<p>AddedAffinity is applied to all Pods additionally to the NodeAffinity
@@ -581,7 +581,7 @@ The default strategy is LeastAllocated with an equal &quot;cpu&quot; and &quot;m
581581

582582

583583
<tr><td><code>defaultConstraints</code><br/>
584-
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#topologyspreadconstraint-v1-core"><code>[]core/v1.TopologySpreadConstraint</code></a>
584+
<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.36/#topologyspreadconstraint-v1-core"><code>[]core/v1.TopologySpreadConstraint</code></a>
585585
</td>
586586
<td>
587587
<p>DefaultConstraints defines topology spread constraints to be applied to
@@ -964,7 +964,7 @@ for that plugin.</p>
964964
- [PluginSet](#kubescheduler-config-k8s-io-v1-PluginSet)
965965

966966

967-
<p>Plugin specifies a plugin name and its weight when applicable. Weight is used only for Score plugins.</p>
967+
<p>Plugin specifies a plugin name and its weight when applicable. Weight is used only for Score and PlacementScore plugins.</p>
968968

969969

970970
<table class="table">
@@ -983,7 +983,7 @@ for that plugin.</p>
983983
<code>int32</code>
984984
</td>
985985
<td>
986-
<p>Weight defines the weight of plugin, only used for Score plugins.</p>
986+
<p>Weight defines the weight of plugin, only used for Score and PlacementScore plugins.</p>
987987
</td>
988988
</tr>
989989
</tbody>
@@ -1191,6 +1191,20 @@ plugin through MultiPoint. This follows the same behavior as all other extension
11911191
</ol>
11921192
</td>
11931193
</tr>
1194+
<tr><td><code>placementGenerate</code> <B>[Required]</B><br/>
1195+
<a href="#kubescheduler-config-k8s-io-v1-PluginSet"><code>PluginSet</code></a>
1196+
</td>
1197+
<td>
1198+
<p>PlacementGenerate is a list of plugins that should be invoked during pod group scheduling cycle when determining placements for a pod group.</p>
1199+
</td>
1200+
</tr>
1201+
<tr><td><code>placementScore</code> <B>[Required]</B><br/>
1202+
<a href="#kubescheduler-config-k8s-io-v1-PluginSet"><code>PluginSet</code></a>
1203+
</td>
1204+
<td>
1205+
<p>PlacementScore is a list of plugins that should be invoked during workload scheduling cycle when ranking pod group assignments.</p>
1206+
</td>
1207+
</tr>
11941208
</tbody>
11951209
</table>
11961210

0 commit comments

Comments
 (0)