Merge pull request #30826 from tengqm/fix-configapi-123

Improve configuration API for 1.23

Author: k8s-ci-robot

content/en/docs/reference/_index.md

@@ -73,14 +73,16 @@ configure  kubernetes components or tools. Most of these APIs are not exposed
 by the API server in a RESTful way though they are essential for a user or an
 operator to use or manage a cluster.
 
-* [kube-apiserver configuration (v1beta1)](/docs/reference/config-api/apiserver-config.v1beta1/)
-* [kubelet configuration (v1alpha1)](/docs/reference/config-api/kubelet-config.v1alpha1/)
-* [kubelet configuration (v1beta1)](/docs/reference/config-api/kubelet-config.v1beta1/)
-* [kube-scheduler configuration (v1beta2)](/docs/reference/config-api/kube-scheduler-config.v1beta2/)
-* [kube-scheduler configuration (v1beta3)](/docs/reference/config-api/kube-scheduler-config.v1beta3/)
+
+* [kube-apiserver configuration (v1)](/docs/reference/config-api/apiserver-config.v1/)
+* [kubelet configuration (v1alpha1)](/docs/reference/config-api/kubelet-config.v1alpha1/) and
+  [kubelet configuration (v1beta1)](/docs/reference/config-api/kubelet-config.v1beta1/)
+* [kube-scheduler configuration (v1beta2)](/docs/reference/config-api/kube-scheduler-config.v1beta2/) and
+  [kube-scheduler configuration (v1beta3)](/docs/reference/config-api/kube-scheduler-config.v1beta3/)
 * [kube-proxy configuration (v1alpha1)](/docs/reference/config-api/kube-proxy-config.v1alpha1/)
 * [`audit.k8s.io/v1` API](/docs/reference/config-api/apiserver-audit.v1/)
-* [Client authentication API (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/)
+* [Client authentication API (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/) and 
+  [Client authentication API (v1)](/docs/reference/config-api/client-authentication.v1/)
 * [WebhookAdmission configuration (v1)](/docs/reference/config-api/apiserver-webhookadmission.v1/)
 
 ## Config API for kubeadm

content/en/docs/reference/access-authn-authz/authentication.md

@@ -1232,3 +1232,5 @@ The following `ExecCredential` manifest describes a cluster information sample.
 ## {{% heading "whatsnext" %}}
 
 * Read the [client authentication reference (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/)
+* Read the [client authentication reference (v1)](/docs/reference/config-api/client-authentication.v1/)
+

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

@@ -16,14 +16,12 @@ auto_generated: true
 
 
 
-
 ## `Event`     {#audit-k8s-io-v1-Event}
 
 
 
 
 **Appears in:**
-
 - [EventList](#audit-k8s-io-v1-EventList)
 
 
@@ -81,15 +79,15 @@ For non-resource requests, this is the lower-cased HTTP method.</td>
 
 
 <tr><td><code>user</code> <B>[Required]</B><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#userinfo-v1-authentication"><code>authentication/v1.UserInfo</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#userinfo-v1-authentication"><code>authentication/v1.UserInfo</code></a>
 </td>
 <td>
    Authenticated user information.</td>
 </tr>
 
 
 <tr><td><code>impersonatedUser</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#userinfo-v1-authentication"><code>authentication/v1.UserInfo</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#userinfo-v1-authentication"><code>authentication/v1.UserInfo</code></a>
 </td>
 <td>
    Impersonated user information.</td>
@@ -123,7 +121,7 @@ Does not apply for List-type requests, or non-resource requests.</td>
 
 
 <tr><td><code>responseStatus</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#status-v1-meta"><code>meta/v1.Status</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#status-v1-meta"><code>meta/v1.Status</code></a>
 </td>
 <td>
    The response status, populated even when the ResponseObject is not a Status type.
@@ -154,15 +152,15 @@ at Response Level.</td>
 
 
 <tr><td><code>requestReceivedTimestamp</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
 </td>
 <td>
    Time the request reached the apiserver.</td>
 </tr>
 
 
 <tr><td><code>stageTimestamp</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#microtime-v1-meta"><code>meta/v1.MicroTime</code></a>
 </td>
 <td>
    Time the request reached current audit stage.</td>
@@ -184,8 +182,6 @@ should be short. Annotations are included in the Metadata level.</td>
 
 </tbody>
 </table>
-    
-
 
 ## `EventList`     {#audit-k8s-io-v1-EventList}
 
@@ -206,7 +202,7 @@ EventList is a list of audit Events.
 
 
 <tr><td><code>metadata</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
 </td>
 <td>
    <span class="text-muted">No description provided.</span>
@@ -225,16 +221,13 @@ EventList is a list of audit Events.
 
 </tbody>
 </table>
-    
-
 
 ## `Policy`     {#audit-k8s-io-v1-Policy}
 
 
 
 
 **Appears in:**
-
 - [PolicyList](#audit-k8s-io-v1-PolicyList)
 
 
@@ -252,7 +245,7 @@ categories are logged.
 
 
 <tr><td><code>metadata</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#objectmeta-v1-meta"><code>meta/v1.ObjectMeta</code></a>
 </td>
 <td>
    ObjectMeta is included for interoperability with API infrastructure.Refer to the Kubernetes API documentation for the fields of the <code>metadata</code> field.</td>
@@ -294,8 +287,6 @@ in a rule will override the global default.</td>
 
 </tbody>
 </table>
-    
-
 
 ## `PolicyList`     {#audit-k8s-io-v1-PolicyList}
 
@@ -316,7 +307,7 @@ PolicyList is a list of audit Policies.
 
 
 <tr><td><code>metadata</code><br/>
-<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
+<a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#listmeta-v1-meta"><code>meta/v1.ListMeta</code></a>
 </td>
 <td>
    <span class="text-muted">No description provided.</span>
@@ -335,16 +326,13 @@ PolicyList is a list of audit Policies.
 
 </tbody>
 </table>
-    
-
 
 ## `GroupResources`     {#audit-k8s-io-v1-GroupResources}
 
 
 
 
 **Appears in:**
-
 - [PolicyRule](#audit-k8s-io-v1-PolicyRule)
 
 
@@ -397,34 +385,27 @@ An empty list implies that every instance of the resource is matched.</td>
 
 </tbody>
 </table>
-    
-
 
 ## `Level`     {#audit-k8s-io-v1-Level}
 
 (Alias of `string`)
 
 
 **Appears in:**
-
 - [Event](#audit-k8s-io-v1-Event)
-
 - [PolicyRule](#audit-k8s-io-v1-PolicyRule)
 
 
 Level defines the amount of information logged during auditing
 
 
-    
-
 
 ## `ObjectReference`     {#audit-k8s-io-v1-ObjectReference}
 
 
 
 
 **Appears in:**
-
 - [Event](#audit-k8s-io-v1-Event)
 
 
@@ -509,16 +490,13 @@ The empty string represents the core API group.</td>
 
 </tbody>
 </table>
-    
-
 
 ## `PolicyRule`     {#audit-k8s-io-v1-PolicyRule}
 
 
 
 
 **Appears in:**
-
 - [Policy](#audit-k8s-io-v1-Policy)
 
 
@@ -624,25 +602,19 @@ Policy.OmitManagedFields will stand.</td>
 
 </tbody>
 </table>
-    
-
 
 ## `Stage`     {#audit-k8s-io-v1-Stage}
 
 (Alias of `string`)
 
 
 **Appears in:**
-
 - [Event](#audit-k8s-io-v1-Event)
-
 - [Policy](#audit-k8s-io-v1-Policy)
-
 - [PolicyRule](#audit-k8s-io-v1-PolicyRule)
 
 
 Stage defines the stages in request handling that audit events may be generated.
 
 
-    
 

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

@@ -0,0 +1,91 @@
+---
+title: kube-apiserver Configuration (v1)
+content_type: tool-reference
+package: apiserver.config.k8s.io/v1
+auto_generated: true
+---
+Package v1 is the v1 version of the API.
+
+## Resource Types 
+
+
+- [AdmissionConfiguration](#apiserver-config-k8s-io-v1-AdmissionConfiguration)
+  
+    
+
+## `AdmissionConfiguration`     {#apiserver-config-k8s-io-v1-AdmissionConfiguration}
+    
+
+
+
+
+AdmissionConfiguration provides versioned configuration for admission controllers.
+
+<table class="table">
+<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
+<tbody>
+    
+<tr><td><code>apiVersion</code><br/>string</td><td><code>apiserver.config.k8s.io/v1</code></td></tr>
+<tr><td><code>kind</code><br/>string</td><td><code>AdmissionConfiguration</code></td></tr>
+    
+
+  
+  
+<tr><td><code>plugins</code><br/>
+<a href="#apiserver-config-k8s-io-v1-AdmissionPluginConfiguration"><code>[]AdmissionPluginConfiguration</code></a>
+</td>
+<td>
+   Plugins allows specifying a configuration per admission control plugin.</td>
+</tr>
+    
+  
+</tbody>
+</table>
+
+## `AdmissionPluginConfiguration`     {#apiserver-config-k8s-io-v1-AdmissionPluginConfiguration}
+    
+
+
+
+**Appears in:**
+- [AdmissionConfiguration](#apiserver-config-k8s-io-v1-AdmissionConfiguration)
+
+
+AdmissionPluginConfiguration provides the configuration for a single plug-in.
+
+<table class="table">
+<thead><tr><th width="30%">Field</th><th>Description</th></tr></thead>
+<tbody>
+    
+
+  
+<tr><td><code>name</code> <B>[Required]</B><br/>
+<code>string</code>
+</td>
+<td>
+   Name is the name of the admission controller.
+It must match the registered admission plugin name.</td>
+</tr>
+    
+  
+<tr><td><code>path</code><br/>
+<code>string</code>
+</td>
+<td>
+   Path is the path to a configuration file that contains the plugin's
+configuration</td>
+</tr>
+    
+  
+<tr><td><code>configuration</code><br/>
+<a href="https://godoc.org/k8s.io/apimachinery/pkg/runtime#Unknown"><code>k8s.io/apimachinery/pkg/runtime.Unknown</code></a>
+</td>
+<td>
+   Configuration is an embedded configuration object to be used as the plugin's
+configuration. If present, it will be used instead of the path to the configuration file.</td>
+</tr>
+    
+  
+</tbody>
+</table>
+