From 11215ecab9f8513cd50631707542ad3108d2b9cd Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Sun, 3 Jul 2022 09:34:49 +0800 Subject: [PATCH] [zh-cn] Update reference index --- content/zh-cn/docs/reference/_index.md | 91 +++++++++++++------------- 1 file changed, 44 insertions(+), 47 deletions(-) diff --git a/content/zh-cn/docs/reference/_index.md b/content/zh-cn/docs/reference/_index.md index 69e3707e46..c0ca319c1f 100644 --- a/content/zh-cn/docs/reference/_index.md +++ b/content/zh-cn/docs/reference/_index.md @@ -38,15 +38,14 @@ This section of the Kubernetes documentation contains references. * [API access control](/docs/reference/access-authn-authz/) - details on how Kubernetes controls API access * [Well-Known Labels, Annotations and Taints](/docs/reference/labels-annotations-taints/) --> -## API 参考 +## API 参考 {#api-reference} -* [术语表](/zh/docs/reference/glossary/) - 一个全面的标准化的 Kubernetes 术语表 - -* [Kubernetes API 参考](/zh/docs/reference/kubernetes-api/) +* [术语表](/zh-cn/docs/reference/glossary/) —— 一个全面的、标准化的 Kubernetes 术语表 +* [Kubernetes API 参考](/zh-cn/docs/reference/kubernetes-api/) * [Kubernetes API 单页参考 {{< param "version" >}}](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。 -* [使用 Kubernetes API ](/zh/docs/reference/using-api/) - Kubernetes 的 API 概述 -* [API 的访问控制](/zh/docs/reference/access-authn-authz/) - 关于 Kubernetes 如何控制 API 访问的详细信息 -* [常见的标签、注解和污点](/zh/docs/reference/labels-annotations-taints/) +* [使用 Kubernetes API ](/zh-cn/docs/reference/using-api/) —— Kubernetes 的 API 概述 +* [API 的访问控制](/zh-cn/docs/reference/access-authn-authz/) —— 关于 Kubernetes 如何控制 API 访问的详细信息 +* [常见的标签、注解和污点](/zh-cn/docs/reference/labels-annotations-taints/) -## 官方支持的客户端库 +## 官方支持的客户端库 {#officially-supported-client-libraries} -如果你需要通过编程语言调用 Kubernetes API，你可以使用 -[客户端库](/zh/docs/reference/using-api/client-libraries/)。以下是官方支持的客户端库： +如果你需要通过编程语言调用 Kubernetes API，你可以使用[客户端库](/zh-cn/docs/reference/using-api/client-libraries/)。 +以下是官方支持的客户端库： - [Kubernetes Go 语言客户端库](https://github.com/kubernetes/client-go/) - [Kubernetes Python 语言客户端库](https://github.com/kubernetes-client/python) @@ -83,10 +82,10 @@ client libraries: --> ## CLI -* [kubectl](/zh/docs/reference/kubectl/) - 主要的 CLI 工具，用于运行命令和管理 Kubernetes 集群。 - * [JSONPath](/zh/docs/reference/kubectl/jsonpath/) - 通过 kubectl 使用 - [JSONPath 表达式](https://goessner.net/articles/JsonPath/) 的语法指南。 -* [kubeadm](/zh/docs/reference/setup-tools/kubeadm/) - 此 CLI 工具可轻松配置安全的 Kubernetes 集群。 +* [kubectl](/zh-cn/docs/reference/kubectl/) —— 主要的 CLI 工具，用于运行命令和管理 Kubernetes 集群。 + * [JSONPath](/zh-cn/docs/reference/kubectl/jsonpath/) —— 通过 kubectl 使用 + [JSONPath 表达式](https://goessner.net/articles/JsonPath/) 的语法指南。 +* [kubeadm](/zh-cn/docs/reference/setup-tools/kubeadm/) - 此 CLI 工具可轻松配置安全的 Kubernetes 集群。 -## 组件 +## 组件 {#components} -* [kubelet](/zh/docs/reference/command-line-tools-reference/kubelet/) - - 在每个节点上运行的主代理。kubelet 接收一组 PodSpecs 并确保其所描述的容器健康地运行。 -* [kube-apiserver](/zh/docs/reference/command-line-tools-reference/kube-apiserver/) - +* [kubelet](/zh-cn/docs/reference/command-line-tools-reference/kubelet/) —— + 在每个节点上运行的主代理。kubelet 接收一组 PodSpec 并确保其所描述的容器健康地运行。 +* [kube-apiserver](/zh-cn/docs/reference/command-line-tools-reference/kube-apiserver/) —— REST API，用于验证和配置 API 对象（如 Pod、服务或副本控制器等）的数据。 -* [kube-controller-manager](/zh/docs/reference/command-line-tools-reference/kube-controller-manager/) - +* [kube-controller-manager](/zh-cn/docs/reference/command-line-tools-reference/kube-controller-manager/) —— 一个守护进程，其中包含 Kubernetes 所附带的核心控制回路。 -* [kube-proxy](/zh/docs/reference/command-line-tools-reference/kube-proxy/) - +* [kube-proxy](/zh-cn/docs/reference/command-line-tools-reference/kube-proxy/) —— 可进行简单的 TCP/UDP 流转发或针对一组后端执行轮流 TCP/UDP 转发。 -* [kube-scheduler](/zh/docs/reference/command-line-tools-reference/kube-scheduler/) - +* [kube-scheduler](/zh-cn/docs/reference/command-line-tools-reference/kube-scheduler/) —— 一个调度程序，用于管理可用性、性能和容量。 - * [调度策略](/zh/docs/reference/scheduling/policies) - * [调度配置](/zh/docs/reference/scheduling/config#profiles) - * 应该在控制平面和工作节点上打开的 [端口和协议](/zh/docs/reference/ports-and-protocols/) - - 列表 + * [调度策略](/zh-cn/docs/reference/scheduling/policies) + * [调度配置](/zh-cn/docs/reference/scheduling/config#profiles) + * 应该在控制平面和工作节点上打开的[端口和协议](/zh-cn/docs/reference/ports-and-protocols/)列表 -## 配置 API +## 配置 API {#config-apis} 本节包含用于配置 kubernetes 组件或工具的 "未发布" API 的文档。 尽管这些 API 对于用户或操作者使用或管理集群来说是必不可少的， 它们大都没有以 RESTful 的方式在 API 服务器上公开。 -* [kube-apiserver 配置 (v1alpha1)](/zh/docs/reference/config-api/apiserver-config.v1alpha1/) -* [kube-apiserver 配置 (v1)](/zh/docs/reference/config-api/apiserver-config.v1/) -* [kube-apiserver 加密 (v1)](/zh/docs/reference/config-api/apiserver-encryption.v1/) -* [kube-apiserver 事件速率限制 (v1alpha1)](/zh/docs/reference/config-api/apiserver-eventratelimit.v1/) -* [kubelet 配置 (v1alpha1)](/zh/docs/reference/config-api/kubelet-config.v1alpha1/) 和 - [kubelet 配置 (v1beta1)](/zh/docs/reference/config-api/kubelet-config.v1beta1/) -* [kubelet 凭据驱动 (v1alpha1)](/zh/docs/reference/config-api/kubelet-credentialprovider.v1alpha1/) -* [kubelet 凭据驱动 (v1beta1)](/zh/docs/reference/config-api/kubelet-credentialprovider.v1beta1/) -* [kube-scheduler 配置 (v1beta2)](/zh/docs/reference/config-api/kube-scheduler-config.v1beta2/) 和 - [kube-scheduler 配置 (v1beta3)](/zh/docs/reference/config-api/kube-scheduler-config.v1beta3/) -* [kube-proxy 配置 (v1alpha1)](/zh/docs/reference/config-api/kube-proxy-config.v1alpha1/) -* [`audit.k8s.io/v1` API](/zh/docs/reference/config-api/apiserver-audit.v1/) -* [客户端认证 API (v1beta1)](/zh/docs/reference/config-api/client-authentication.v1beta1/) 和 - [客户端认证 API (v1)](/zh/docs/reference/config-api/client-authentication.v1/) -* [WebhookAdmission 配置 (v1)](/zh/docs/reference/config-api/apiserver-webhookadmission.v1/) -* [ImagePolicy API (v1alpha1)](/zh/docs/reference/config-api/imagepolicy.v1alpha1/) +* [kube-apiserver 配置 (v1alpha1)](/zh-cn/docs/reference/config-api/apiserver-config.v1alpha1/) +* [kube-apiserver 配置 (v1)](/zh-cn/docs/reference/config-api/apiserver-config.v1/) +* [kube-apiserver 加密 (v1)](/zh-cn/docs/reference/config-api/apiserver-encryption.v1/) +* [kube-apiserver 事件速率限制 (v1alpha1)](/zh-cn/docs/reference/config-api/apiserver-eventratelimit.v1/) +* [kubelet 配置 (v1alpha1)](/zh-cn/docs/reference/config-api/kubelet-config.v1alpha1/) 和 + [kubelet 配置 (v1beta1)](/zh-cn/docs/reference/config-api/kubelet-config.v1beta1/) +* [kubelet 凭据驱动 (v1alpha1)](/zh-cn/docs/reference/config-api/kubelet-credentialprovider.v1alpha1/) +* [kubelet 凭据驱动 (v1beta1)](/zh-cn/docs/reference/config-api/kubelet-credentialprovider.v1beta1/) +* [kube-scheduler 配置 (v1beta2)](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta2/) 和 + [kube-scheduler 配置 (v1beta3)](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/) +* [kube-proxy 配置 (v1alpha1)](/zh-cn/docs/reference/config-api/kube-proxy-config.v1alpha1/) +* [`audit.k8s.io/v1` API](/zh-cn/docs/reference/config-api/apiserver-audit.v1/) +* [客户端身份认证 API (v1beta1)](/zh-cn/docs/reference/config-api/client-authentication.v1beta1/) 和 + [客户端身份认证 API (v1)](/zh-cn/docs/reference/config-api/client-authentication.v1/) +* [WebhookAdmission 配置 (v1)](/zh-cn/docs/reference/config-api/apiserver-webhookadmission.v1/) +* [ImagePolicy API (v1alpha1)](/zh-cn/docs/reference/config-api/imagepolicy.v1alpha1/) +## kubeadm 的配置 API {#config-api-for-kubeadm} -## kubeadm 的配置 API - -* [v1beta2](/zh/docs/reference/config-api/kubeadm-config.v1beta2/) -* [v1beta3](/zh/docs/reference/config-api/kubeadm-config.v1beta3/) +* [v1beta2](/zh-cn/docs/reference/config-api/kubeadm-config.v1beta2/) +* [v1beta3](/zh-cn/docs/reference/config-api/kubeadm-config.v1beta3/) -## 设计文档 +## 设计文档 {#design-docs} Kubernetes 功能的设计文档归档，不妨考虑从 [Kubernetes 架构](https://git.k8s.io/design-proposals-archive/architecture/architecture.md) 和