diff --git a/content/zh-cn/docs/reference/config-api/apiserver-config.v1.md b/content/zh-cn/docs/reference/config-api/apiserver-config.v1.md index 9e941c3f49..895bac80e5 100644 --- a/content/zh-cn/docs/reference/config-api/apiserver-config.v1.md +++ b/content/zh-cn/docs/reference/config-api/apiserver-config.v1.md @@ -10,10 +10,12 @@ package: apiserver.config.k8s.io/v1 auto_generated: true --> +

-

v1 包中包含 API 的 v1 版本。

+v1 包中包含 API 的 v1 版本。 +

-

AdmissionConfiguration 为准入控制器提供版本化的配置。

+AdmissionConfiguration 为准入控制器提供版本化的配置。 +

@@ -42,10 +46,12 @@ auto_generated: true []AdmissionPluginConfiguration @@ -57,7 +63,7 @@ auto_generated: true
字段描述
+

-

plugins 字段允许为每个准入控制插件设置配置选项。

+ Plugins allows specifying a configuration per admission control plugin. + --> + plugins 字段允许为每个准入控制插件设置配置选项。 +

- + @@ -73,7 +79,7 @@ This is similar to the --authorization-modes kube-apiserver flag Must be at least one. --> authorizers 是用于针对请求进行鉴权的鉴权组件的有序列表。 -这类似于 `--authorization-modes` kube-apiserver 标志。 +这类似于 --authorization-modes kube-apiserver 标志。 必须至少包含一个元素。

@@ -156,7 +162,7 @@ resources: - resources 是一个包含资源及其对应加密驱动的列表。 + resources 是一个包含资源及其对应加密驱动的列表。

@@ -192,10 +198,10 @@ AESConfiguration 包含针对 AES 转换器的 API 配置。 keys is a list of keys to be used for creating the AES transformer. Each key has to be 32 bytes long for AES-CBC and 16, 24 or 32 bytes for AES-GCM. --> - keys 是一个用于创建 AES 转换器的密钥列表。 + keys 是一个用于创建 AES 转换器的密钥列表。 对于 AES-CBC，每个密钥的长度必须是 32 字节； 对于 AES-GCM，每个密钥的长度可以是 16、24 或 32 字节。 -

+

@@ -219,15 +225,17 @@ AESConfiguration 包含针对 AES 转换器的 API 配置。 - @@ -235,11 +243,13 @@ It must match the registered admission plugin name.

string @@ -247,12 +257,14 @@ configuration

k8s.io/apimachinery/pkg/runtime.Unknown @@ -260,7 +272,7 @@ configuration. If present, it will be used instead of the path to the configurat
字段描述
apiVersion
string		apiserver.config.k8s.io/v1
kind
string		AuthorizationConfiguration
字段描述
name [必需]
+
name [必需]
string 		+

-

name 是准入控制器的名称。它必须与所注册的准入插件名称匹配。

+ name 是准入控制器的名称。它必须与所注册的准入插件名称匹配。 +

+

-

path 是指向包含插件配置信息的配置文件的路径。

+ path 是指向包含插件配置信息的配置文件的路径。 +

+

-

configuration 是一个内嵌的配置对象，用来保存插件的配置信息。 - 如果存在，则使用这里的配置信息而不是指向配置文件的路径。

+ configuration 是一个内嵌的配置对象，用来保存插件的配置信息。 + 如果存在，则使用这里的配置信息而不是指向配置文件的路径。 +

## `AuthorizerConfiguration` {#apiserver-config-k8s-io-v1-AuthorizerConfiguration} - + @@ -363,7 +375,7 @@ KMSConfiguration 包含 KMS 型信封转换器所用的配置文件的名称、 - + @@ -384,7 +396,7 @@ KMSConfiguration 包含 KMS 型信封转换器所用的配置文件的名称、 - name 是要使用的 KMS 插件的名称。 + name 是要使用的 KMS 插件的名称。

@@ -397,9 +409,9 @@ KMSConfiguration 包含 KMS 型信封转换器所用的配置文件的名称、 cachesize is the maximum number of secrets which are cached in memory. The default value is 1000. Set to a negative value to disable caching. This field is only allowed for KMS v1 providers. --> - cachesize 是内存中缓存的最大 Secret 数量。默认值为 1000。 + cachesize 是内存中缓存的最大 Secret 数量。默认值为 1000。 设置为负值将禁用缓存。此字段仅允许用于 KMS v1 驱动。 -

+

@@ -422,7 +434,7 @@ KMSConfiguration 包含 KMS 型信封转换器所用的配置文件的名称、 - timeout 是 gRPC 调用到 KMS 插件的超时时间（例如 5s）。默认值为 3 秒。 + timeout 是 gRPC 调用到 KMS 插件的超时时间（例如 5s）。默认值为 3 秒。

@@ -449,7 +461,7 @@ Key 包含为转换器所提供的密钥的名称和 Secret。
字段描述
apiVersion
string
endpoint [必需]
@@ -410,7 +422,7 @@ KMSConfiguration 包含 KMS 型信封转换器所用的配置文件的名称、 - endpoint 是 gRPC 服务器的监听地址，例如 "unix:///var/run/kms-provider.sock"。 + endpoint 是 gRPC 服务器的监听地址，例如 "unix:///var/run/kms-provider.sock"。

- + @@ -458,7 +470,7 @@ Key 包含为转换器所提供的密钥的名称和 Secret。 - name 是在将数据存储到磁盘时所使用的密钥名称。 + name 是在将数据存储到磁盘时所使用的密钥名称。

@@ -470,7 +482,7 @@ Key 包含为转换器所提供的密钥的名称和 Secret。 - secret 是实际的密钥，以 base64 编码。 + secret 是实际的密钥，以 base64 编码。

@@ -505,7 +517,7 @@ ProviderConfiguration 存储为加密驱动提供的配置。 - aesgcm 是 AES-GCM 转换器的配置。 + aesgcm 是 AES-GCM 转换器的配置。

@@ -517,7 +529,7 @@ ProviderConfiguration 存储为加密驱动提供的配置。 - aescbc 是 AES-CBC 转换器的配置。 + aescbc 是 AES-CBC 转换器的配置。

@@ -529,7 +541,7 @@ ProviderConfiguration 存储为加密驱动提供的配置。 - secretbox 是基于 Secretbox 的转换器的配置。 + secretbox 是基于 Secretbox 的转换器的配置。

@@ -541,7 +553,7 @@ ProviderConfiguration 存储为加密驱动提供的配置。 - identity 是身份转换器的（空）配置。 + identity 是身份转换器的（空）配置。

@@ -553,7 +565,7 @@ ProviderConfiguration 存储为加密驱动提供的配置。 - kms 包含 KMS 型信封转换器所用的配置文件的名称、缓存大小和路径。 + kms 包含 KMS 型信封转换器所用的配置文件的名称、缓存大小和路径。

@@ -592,13 +604,13 @@ Use '*.*' to encrypt all resources and '*.<group>' to encrypt eg: '*.awesome.bears.example' will encrypt all resources in the group 'awesome.bears.example'. eg: '*.' will encrypt all resources in the core group (such as pods, configmaps, etc). --> - resources 是一个需要加密的 Kubernetes 资源列表。 + resources 是一个需要加密的 Kubernetes 资源列表。 资源名称来源于组/版本/资源的 “resource” 或 “resource.group”。 例如，pandas.awesome.bears.example 是一个自定义资源，其 “group” 为 awesome.bears.example， “resource” 为 pandas。使用 “*.*” 以加密所有资源，使用 “*.<group>” 以加密特定组中的所有资源。 例如，“*.awesome.bears.example” 将加密 “awesome.bears.example” 组中的所有资源。 再比如，“*.” 将加密核心组中的所有资源（如 Pod、ConfigMap 等）。 -

+

@@ -647,7 +659,7 @@ SecretboxConfiguration 包含 Secretbox 转换器的 API 配置。 keys is a list of keys to be used for creating the Secretbox transformer. Each key has to be 32 bytes long. --> - keys 是一个用于创建 Secretbox 转换器的密钥列表。每个密钥的长度必须为 32 字节。 + keys 是一个用于创建 Secretbox 转换器的密钥列表。每个密钥的长度必须为 32 字节。

@@ -890,7 +902,7 @@ allowed for kube-apiserver. Path to KubeConfigFile for connection info Required, if connectionInfo.Type is KubeConfig --> -KubeConfig 文件的路径，用于获取连接信息。 +kubeConfigFile 文件的路径，用于获取连接信息。 如果 connectionInfo.type 是 KubeConfig，则必需。

@@ -936,7 +948,8 @@ CEL 表达式可以访问 v1 版本中的 SubjectAccessReview 的内容。
  • 'extra' corresponds to the user.Info.GetExtra() method from the authenticator.
  • 'uid' is the information about the requesting user. e.g. request.uid == '1'
    • --> -
  • 'resourceAttributes' 描述了资源访问请求的信息，在非资源请求中未设置。例如：has(request.resourceAttributes) && request.resourceAttributes.namespace == 'default'。 +
  • 'resourceAttributes' 描述了资源访问请求的信息，在非资源请求中未设置。 +例如：has(request.resourceAttributes) && request.resourceAttributes.namespace == 'default'。
  • 'nonResourceAttributes' 描述了非资源访问请求的信息，在资源请求中未设置。例如： has(request.nonResourceAttributes) && request.nonResourceAttributes.path == '/healthz'。 @@ -950,7 +963,7 @@ CEL 表达式可以访问 v1 版本中的 SubjectAccessReview 的内容。 -关于 CEL 的文档：https://kubernetes.io/docs/reference/using-api/cel/ +关于 CEL 的文档：https://kubernetes.io/zh-cn/docs/reference/using-api/cel/

    • 字段描述
    name [必需]
    string
    providers [必需]
    @@ -610,9 +622,9 @@ eg: '*.' will encrypt all resources in the core group (such as pods, configm providers is a list of transformers to be used for reading and writing the resources to disk. eg: aesgcm, aescbc, secretbox, identity, kms. --> - providers 是从磁盘读取资源和写入资源到磁盘要使用的转换器的列表。 + providers 是从磁盘读取资源和写入资源到磁盘要使用的转换器的列表。 例如：aesgcm、aescbc、secretbox、identity、kms。 -

    +