From 5b4e2d465206c3cdc0f575ff0189d42e0f388452 Mon Sep 17 00:00:00 2001 From: windsonsea Date: Mon, 2 Oct 2023 18:33:18 +0800 Subject: [PATCH] [zh] Update kubernetes-api/ files --- .../service-account-v1.md | 86 ++++++------------- .../kubernetes-api/other-resources/_index.md | 12 --- ...-admission-policy-binding-list-v1alpha1.md | 29 ++----- 3 files changed, 33 insertions(+), 94 deletions(-) diff --git a/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md b/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md index e8d1e511d6e5e..2f2e52efc4a2b 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md @@ -7,9 +7,7 @@ content_type: "api_reference" description: "ServiceAccount 将以下内容绑定在一起：1. 用户可以理解的名称，也可能是外围系统理解的身份标识 2. 可以验证和授权的主体 3. 一组 Secret。" title: "ServiceAccount" weight: 1 -auto_generated: true --- - - - `apiVersion: v1` `import "k8s.io/api/core/v1"` - ## ServiceAccount {#ServiceAccount} ServiceAccount 将以下内容绑定在一起： + * 用户可以理解的名称，也可能是外围系统理解的身份标识 * 可以验证和授权的主体 * 一组 Secret @@ -52,16 +39,15 @@ ServiceAccount 将以下内容绑定在一起： - **apiVersion**: v1 - - **kind**: ServiceAccount - - **metadata** (}}">ObjectMeta) - 标准对象的元数据，更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + 标准对象的元数据，更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **automountServiceAccountToken** (boolean) @@ -77,8 +63,8 @@ ServiceAccount 将以下内容绑定在一起： ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet. More info: https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod --> imagePullSecrets 是对同一命名空间中 Secret 的引用列表，用于拉取引用此 ServiceAccount 的 Pod 中的任何镜像。 - imagePullSecrets 与 Secrets 不同，因为 Secrets 可以挂载在 Pod 中，但 imagePullSecrets 只能由 kubelet 访问。 - 更多信息： https://kubernetes.io/zh-cn/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod + imagePullSecrets 与 Secret 不同，因为 Secret 可以挂载在 Pod 中，但 imagePullSecrets 只能由 kubelet 访问。更多信息： + https://kubernetes.io/zh-cn/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod - **secrets** ([]}}">ObjectReference) @@ -94,7 +80,7 @@ ServiceAccount 将以下内容绑定在一起： --> **补丁策略：基于键 `name` 合并** - Secrets 是允许使用此 ServiceAccount 运行的 Pod 使用的同一命名空间中的秘密列表。 + secrets 是允许使用此 ServiceAccount 运行的 Pod 使用的同一命名空间中的秘密列表。 仅当此服务帐户的 “kubernetes.io/enforce-mountable-secrets” 注释设置为 “true” 时，Pod 才限于此列表。 此字段不应用于查找自动生成的服务帐户令牌机密以在 Pod 之外使用。 相反，可以使用 TokenRequest API 直接请求令牌，或者可以手动创建服务帐户令牌 Secret。 @@ -111,16 +97,15 @@ ServiceAccountList 是 ServiceAccount 对象的列表 - **apiVersion**: v1 - - **kind**: ServiceAccountList - - **metadata** (}}">ListMeta) - 标准列表元数据, 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + 标准列表元数据, 更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - ServiceAccount 列表，更多信息： https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-service-account/ + ServiceAccount 列表，更多信息： + https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-service-account/ - **name** (**路径参数**): string, 必需 - - ServiceAccount 的名称 + ServiceAccount 的名称。 @@ -337,7 +321,6 @@ GET /api/v1/serviceaccounts }}">fieldSelector - @@ -394,7 +377,6 @@ GET /api/v1/serviceaccounts }}">watch - @@ -453,7 +435,6 @@ POST /api/v1/namespaces/{namespace}/serviceaccounts }}">fieldValidation - @@ -461,7 +442,6 @@ POST /api/v1/namespaces/{namespace}/serviceaccounts }}">pretty - @@ -480,7 +460,7 @@ POST /api/v1/namespaces/{namespace}/serviceaccounts #### HTTP Request --> -`update` 替换指定的ServiceAccount +### `update` 替换指定的 ServiceAccount #### HTTP 请求 @@ -493,11 +473,12 @@ PUT /api/v1/namespaces/{namespace}/serviceaccounts/{name} -- **name** (**路径参数**): string, required name of the ServiceAccount +--> +- **name** (**路径参数**): string，必需 + ServiceAccount 的名称。 @@ -556,7 +536,7 @@ PUT /api/v1/namespaces/{namespace}/serviceaccounts/{name} #### HTTP Request --> -`patch` 部分更新指定的 ServiceAccount +### `patch` 部分更新指定的 ServiceAccount #### HTTP 请求 @@ -569,13 +549,12 @@ PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name} - **name** (**路径参数**): string，必需 - - ServiceAccount 的名称 + ServiceAccount 的名称。 @@ -616,7 +594,6 @@ PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name} }}">force - @@ -624,13 +601,11 @@ PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name} }}">pretty - #### 响应 - 200 (}}">ServiceAccount): OK 201 (}}">ServiceAccount): Created @@ -643,8 +618,8 @@ PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name} #### HTTP Request --> ### `delete` 删除一个 ServiceAccount -#### HTTP 请求 +#### HTTP 请求 DELETE /api/v1/namespaces/{namespace}/serviceaccounts/{name} @@ -655,14 +630,12 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts/{name} -- **name** (**路径参数**): string，必需 - - ServiceAccount 的名称 +--> +- **name** (**路径参数**): string，必需 + ServiceAccount 的名称。 @@ -696,12 +667,10 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts/{name} }}">pretty - - **propagationPolicy** (*in query*): string }}">propagationPolicy - @@ -736,7 +705,6 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts }}">namespace - - **body**: }}">DeleteOptions @@ -761,7 +728,6 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts }}">fieldSelector - @@ -783,7 +749,6 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts }}">limit - @@ -826,7 +791,6 @@ DELETE /api/v1/namespaces/{namespace}/serviceaccounts }}">timeoutSeconds - diff --git a/content/zh-cn/docs/reference/kubernetes-api/other-resources/_index.md b/content/zh-cn/docs/reference/kubernetes-api/other-resources/_index.md index 12865e2ef11b5..9be5735dcd0ea 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/other-resources/_index.md +++ b/content/zh-cn/docs/reference/kubernetes-api/other-resources/_index.md @@ -7,15 +7,3 @@ title: "Other Resources" weight: 10 auto_generated: true --> - - - diff --git a/content/zh-cn/docs/reference/kubernetes-api/other-resources/validating-admission-policy-binding-list-v1alpha1.md b/content/zh-cn/docs/reference/kubernetes-api/other-resources/validating-admission-policy-binding-list-v1alpha1.md index abb9b7c4c834e..dffd13e539838 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/other-resources/validating-admission-policy-binding-list-v1alpha1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/other-resources/validating-admission-policy-binding-list-v1alpha1.md @@ -1,38 +1,25 @@ --- api_metadata: - apiVersion: "admissionregistration.k8s.io/v1alpha1" - import: "k8s.io/api/admissionregistration/v1alpha1" + apiVersion: "admissionregistration.k8s.io/v1beta1" + import: "k8s.io/api/admissionregistration/v1beta1" kind: "ValidatingAdmissionPolicyBindingList" content_type: "api_reference" description: "" -title: "ValidatingAdmissionPolicyBindingList v1alpha1" +title: "ValidatingAdmissionPolicyBindingList v1beta1" weight: 1 --- - - -`apiVersion: admissionregistration.k8s.io/v1alpha1` - -`import "k8s.io/api/admissionregistration/v1alpha1"` - +`apiVersion: admissionregistration.k8s.io/v1beta1` +`import "k8s.io/api/admissionregistration/v1beta1"`