Skip to content

Commit c73d051

Browse files
CaoDonghui123CaoDonghui123
committed
[zh]Resync Reference files[11]
1 parent fe81c57 commit c73d051

File tree

2 files changed

+184
-28
lines changed

2 files changed

+184
-28
lines changed

‎content/zh/docs/reference/_index.md

Lines changed: 86 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ linkTitle: "Reference"
1515
main_menu: true
1616
weight: 70
1717
content_type: concept
18+
no_list: true
1819
-->
1920

2021
<!-- overview -->
@@ -29,16 +30,26 @@ This section of the Kubernetes documentation contains references.
2930
<!--
3031
## API Reference
3132
32-
* [API Reference for Kubernetes {{< param "version" >}}](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
33+
* [Glossary](/docs/reference/glossary/) - a comprehensive, standardized list of Kubernetes terminology
34+
35+
* [Kubernetes API Reference](/docs/reference/kubernetes-api/)
36+
* [One-page API Reference for Kubernetes {{< param "version" >}}](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
3337
* [Using The Kubernetes API](/docs/reference/using-api/) - overview of the API for Kubernetes.
38+
* [API access control](/docs/reference/access-authn-authz/) - details on how Kubernetes controls API access
39+
* [Well-Known Labels, Annotations and Taints](/docs/reference/labels-annotations-taints/)
3440
-->
3541
## API 参考
3642

43+
* [术语表](/zh/docs/reference/glossary/) - 一个全面的标准化的 Kubernetes 术语表
44+
45+
* [Kubernetes API 单页参考](/zh/docs/reference/kubernetes-api/)
3746
* [Kubernetes API 参考 {{< param "version" >}}](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。
3847
* [使用 Kubernetes API ](/zh/docs/reference/using-api/) - Kubernetes 的 API 概述
48+
* [API 的访问控制](/zh/docs/reference/access-authn-authz/) - 关于 Kubernetes 如何控制 API 访问的详细信息
49+
* [常见的标签、注解和污点](/zh/docs/reference/labels-annotations-taints/)
3950

4051
<!--
41-
## API Client Libraries
52+
## Officially supported client libraries
4253
4354
To call the Kubernetes API from a programming language, you can use
4455
[client libraries](/docs/reference/using-api/client-libraries/). Officially supported
@@ -48,8 +59,10 @@ client libraries:
4859
- [Kubernetes Python client library](https://github.com/kubernetes-client/python)
4960
- [Kubernetes Java client library](https://github.com/kubernetes-client/java)
5061
- [Kubernetes JavaScript client library](https://github.com/kubernetes-client/javascript)
62+
- [Kubernetes Dotnet client library](https://github.com/kubernetes-client/csharp)
63+
- [Kubernetes Haskell Client library](https://github.com/kubernetes-client/haskell)
5164
-->
52-
## API 客户端库
65+
## 官方支持的客户端库
5366

5467
如果您需要通过编程语言调用 Kubernetes API，您可以使用
5568
[客户端库](/zh/docs/reference/using-api/client-libraries/)。以下是官方支持的客户端库：
@@ -58,46 +71,93 @@ client libraries:
5871
- [Kubernetes Python 语言客户端库](https://github.com/kubernetes-client/python)
5972
- [Kubernetes Java 语言客户端库](https://github.com/kubernetes-client/java)
6073
- [Kubernetes JavaScript 语言客户端库](https://github.com/kubernetes-client/javascript)
74+
- [Kubernetes Dotnet 语言客户端库](https://github.com/kubernetes-client/csharp)
75+
- [Kubernetes Haskell 语言客户端库](https://github.com/kubernetes-client/haskell)
6176

6277
<!--
63-
## CLI Reference
78+
## CLI
6479
65-
* [kubectl](/docs/user-guide/kubectl-overview) - Main CLI tool for running commands and managing Kubernetes clusters.
66-
* [JSONPath](/docs/user-guide/jsonpath/) - Syntax guide for using [JSONPath expressions](http://goessner.net/articles/JsonPath/) with kubectl.
67-
* [kubeadm](/docs/admin/kubeadm/) - CLI tool to easily provision a secure Kubernetes cluster.
68-
* [kubefed](/docs/admin/kubefed/) - CLI tool to help you administrate your federated clusters.
80+
* [kubectl](/docs/reference/kubectl/overview/) - Main CLI tool for running commands and managing Kubernetes clusters.
81+
* [JSONPath](/docs/reference/kubectl/jsonpath/) - Syntax guide for using [JSONPath expressions](https://goessner.net/articles/JsonPath/) with kubectl.
82+
* [kubeadm](/docs/reference/setup-tools/kubeadm/) - CLI tool to easily provision a secure Kubernetes cluster.
6983
-->
70-
## CLI 参考
84+
## CLI
7185

7286
* [kubectl](/zh/docs/reference/kubectl/overview/) - 主要的 CLI 工具，用于运行命令和管理 Kubernetes 集群。
7387
* [JSONPath](/zh/docs/reference/kubectl/jsonpath/) - 通过 kubectl 使用
7488
[JSONPath 表达式](https://goessner.net/articles/JsonPath/) 的语法指南。
7589
* [kubeadm](/zh/docs/reference/setup-tools/kubeadm/) - 此 CLI 工具可轻松配置安全的 Kubernetes 集群。
7690

7791
<!--
78-
## Components Reference
79-
80-
* [kubelet](/docs/reference/command-line-tools-reference/kubelet/) - The primary *node agent* that runs on each node. The kubelet takes a set of PodSpecs and ensures that the described containers are running and healthy.
81-
* [kube-apiserver](/docs/reference/command-line-tools-reference/kube-apiserver/) - REST API that validates and configures data for API objects such as pods, services, replication controllers.
92+
## Components
93+
94+
* [kubelet](/docs/reference/command-line-tools-reference/kubelet/) - The
95+
primary agent that runs on each node. The kubelet takes a set of PodSpecs
96+
and ensures that the described containers are running and healthy.
97+
* [kube-apiserver](/docs/reference/command-line-tools-reference/kube-apiserver/) -
98+
REST API that validates and configures data for API objects such as pods,
99+
services, replication controllers.
82100
* [kube-controller-manager](/docs/reference/command-line-tools-reference/kube-controller-manager/) - Daemon that embeds the core control loops shipped with Kubernetes.
83-
* [kube-proxy](/docs/reference/command-line-tools-reference/kube-proxy/) - Can do simple TCP/UDP stream forwarding or round-robin TCP/UDP forwarding across a set of back-ends.
101+
* [kube-proxy](/docs/reference/command-line-tools-reference/kube-proxy/) - Can
102+
do simple TCP/UDP stream forwarding or round-robin TCP/UDP forwarding across
103+
a set of back-ends.
84104
* [kube-scheduler](/docs/reference/command-line-tools-reference/kube-scheduler/) - Scheduler that manages availability, performance, and capacity.
85-
* [kube-scheduler Policies](/docs/reference/scheduling/policies)
86-
* [kube-scheduler Profiles](/docs/reference/scheduling/config#profiles)
105+
106+
* [Scheduler Policies](/docs/reference/scheduling/policies)
107+
* [Scheduler Profiles](/docs/reference/scheduling/config#profiles)
108+
-->
109+
## 组件
110+
111+
* [kubelet](/zh/docs/reference/command-line-tools-reference/kubelet/) -
112+
在每个节点上运行的主代理。kubelet 接收一组 PodSpecs 并确保其所描述的容器健康地运行。
113+
* [kube-apiserver](/zh/docs/reference/command-line-tools-reference/kube-apiserver/) -
114+
REST API，用于验证和配置 API 对象（如 Pod、服务或副本控制器等）的数据。
115+
* [kube-controller-manager](/zh/docs/reference/command-line-tools-reference/kube-controller-manager/) -
116+
一个守护进程，其中包含 Kubernetes 所附带的核心控制回路。
117+
* [kube-proxy](/zh/docs/reference/command-line-tools-reference/kube-proxy/) -
118+
可进行简单的 TCP/UDP 流转发或针对一组后端执行轮流 TCP/UDP 转发。
119+
* [kube-scheduler](/zh/docs/reference/command-line-tools-reference/kube-scheduler/) -
120+
一个调度程序，用于管理可用性、性能和容量。
121+
122+
* [调度策略](/zh/docs/reference/scheduling/policies)
123+
* [调度配置](/zh/docs/reference/scheduling/config#profiles)
124+
125+
<!--
126+
## Config APIs
127+
128+
This section hosts the documentation for "unpublished" APIs which are used to
129+
configure kubernetes components or tools. Most of these APIs are not exposed
130+
by the API server in a RESTful way though they are essential for a user or an
131+
operator to use or manage a cluster.
132+
133+
* [kubelet configuration (v1beta1)](/docs/reference/config-api/kubelet-config.v1beta1/)
134+
* [kube-scheduler configuration (v1beta1)](/docs/reference/config-api/kube-scheduler-config.v1beta1/)
135+
* [kube-scheduler policy reference (v1)](/docs/reference/config-api/kube-scheduler-policy-config.v1/)
136+
* [kube-proxy configuration (v1alpha1)](/docs/reference/config-api/kube-proxy-config.v1alpha1/)
137+
* [`audit.k8s.io/v1` API](/docs/reference/config-api/apiserver-audit.v1/)
138+
* [Client authentication API (v1beta1)](/docs/reference/config-api/client-authentication.v1beta1/)
139+
* [WebhookAdmission configuration (v1)](/docs/reference/config-api/apiserver-webhookadmission.v1/)
87140
-->
88-
## 组件参考
89-
90-
* [kubelet](/zh/docs/reference/command-line-tools-reference/kubelet/) - 在每个节点上运行的主 *节点代理* 。kubelet 采用一组 PodSpecs 并确保所描述的容器健康地运行。
91-
* [kube-apiserver](/zh/docs/reference/command-line-tools-reference/kube-apiserver/) - REST API，用于验证和配置 API 对象（如 Pod、服务或副本控制器等）的数据。
92-
* [kube-controller-manager](/zh/docs/reference/command-line-tools-reference/kube-controller-manager/) - 一个守护进程，它嵌入到了 Kubernetes 的附带的核心控制循环。
93-
* [kube-proxy](/zh/docs/reference/command-line-tools-reference/kube-proxy/) - 可进行简单的 TCP/UDP 流转发或针对一组后端执行轮流 TCP/UDP 转发。
94-
* [kube-scheduler](/zh/docs/reference/command-line-tools-reference/kube-scheduler/) - 一个调度程序，用于管理可用性、性能和容量。
95-
* [kube-scheduler 策略](/zh/docs/reference/scheduling/policies)
96-
* [kube-scheduler 配置](/zh/docs/reference/scheduling/config#profiles)
141+
## 配置 API
142+
143+
本节包含用于配置 kubernetes 组件或工具的 "未发布" API 的文档。
144+
尽管这些 API 对于用户或操作者使用或管理集群来说是必不可少的，
145+
它们大都没有以 RESTful 的方式在 API 服务器上公开。
146+
147+
* [kubelet 配置 (v1beta1)](/zh/docs/reference/config-api/kubelet-config.v1beta1/)
148+
* [kube-scheduler 配置 (v1beta1)](/zh/docs/reference/config-api/kube-scheduler-config.v1beta1/)
149+
* [kube-scheduler 策略参考 (v1)](/zh/docs/reference/config-api/kube-scheduler-policy-config.v1/)
150+
* [kube-proxy 配置 (v1alpha1)](/zh/docs/reference/config-api/kube-proxy-config.v1alpha1/)
151+
* [`audit.k8s.io/v1` API](/zh/docs/reference/config-api/apiserver-audit.v1/)
152+
* [客户端认证 API (v1beta1)](/zh/docs/reference/config-api/client-authentication.v1beta1/)
153+
* [WebhookAdmission 配置 (v1)](/zh/docs/reference/config-api/apiserver-webhookadmission.v1/)
154+
97155
<!--
98156
## Design Docs
99157
100-
An archive of the design docs for Kubernetes functionality. Good starting points are [Kubernetes Architecture](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) and [Kubernetes Design Overview](https://git.k8s.io/community/contributors/design-proposals).
158+
An archive of the design docs for Kubernetes functionality. Good starting points are
159+
[Kubernetes Architecture](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) and
160+
[Kubernetes Design Overview](https://git.k8s.io/community/contributors/design-proposals).
101161
-->
102162
## 设计文档
103163

‎content/zh/docs/reference/labels-annotations-taints.md

Lines changed: 98 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,26 @@ The Kubelet populates this with `runtime.GOOS` as defined by Go. This can be han
4646
-->
4747
Kubelet 用 Go 定义的 `runtime.GOOS` 生成该标签的键值。在混合使用异构操作系统场景下（例如：混合使用 Linux 和 Windows 节点），此键值可以带来极大便利。
4848

49+
## kubernetes.io/metadata.name
50+
51+
示例：`kubernetes.io/metadata.name=mynamespace`
52+
53+
用于：Namespaces
54+
55+
<!--
56+
When the `NamespaceDefaultLabelName`
57+
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) is enabled,
58+
the Kubernetes API server sets this label on all namespaces. The label value is set to
59+
the name of the namespace.
60+
61+
This is useful if you want to target a specific namespace with a label
62+
{{< glossary_tooltip text="selector" term_id="selector" >}}.
63+
-->
64+
当 `NamespaceDefaultLabelName` [特性门控](/zh/docs/reference/command-line-tools-reference/feature-gates/)
65+
被启用时，Kubernetes API 服务器会在所有命名空间上设置此标签。标签值被设置为命名空间的名称。
66+
67+
如果你想使用标签 {{< glossary_tooltip text="选择器" term_id="selector" >}} 来指向特定的命名空间，这很有用。
68+
4969
## beta.kubernetes.io/arch (deprecated)
5070

5171
<!--
@@ -75,6 +95,19 @@ Kubelet 用主机名生成此标签。需要注意的是主机名可修改，这
7595

7696
此标签也可用做拓扑层次的一个部分。更多信息参见[topology.kubernetes.io/zone](#topologykubernetesiozone)。
7797

98+
## controller.kubernetes.io/pod-deletion-cost {#pod-deletion-cost}
99+
100+
示例：`controller.kubernetes.io/pod-deletion-cost=10`
101+
102+
用于：Pod
103+
104+
<!--
105+
This annotation is used to set [Pod Deletion Cost](/docs/concepts/workloads/controllers/replicaset/#pod-deletion-cost)
106+
which allows users to influence ReplicaSet downscaling order. The annotation parses into an `int32` type.
107+
-->
108+
该注解用于设置 [Pod 删除开销](/zh/docs/concepts/workloads/controllers/replicaset/#pod-deletion-cost)，
109+
允许用户影响 ReplicaSet 的缩减顺序。该注解解析为 `int32` 类型。
110+
78111
## beta.kubernetes.io/instance-type (deprecated)
79112

80113
{{< note >}}
@@ -124,6 +157,22 @@ Starting in v1.17, this label is deprecated in favor of [topology.kubernetes.io/
124157
从 v1.17 开始，此标签被弃用，取而代之的是 [topology.kubernetes.io/zone](#topologykubernetesiozone).
125158
{{< /note >}}
126159

160+
## statefulset.kubernetes.io/pod-name {#statefulsetkubernetesiopod-name}
161+
162+
示例：`statefulset.kubernetes.io/pod-name=mystatefulset-7`
163+
164+
<!--
165+
When a StatefulSet controller creates a Pod for the StatefulSet, the control plane
166+
sets this label on that Pod. The value of the label is the name of the Pod being created.
167+
168+
See [Pod Name Label](/docs/concepts/workloads/controllers/statefulset/#pod-name-label) in the
169+
StatefulSet topic for more details.
170+
-->
171+
当 StatefulSet 控制器为 StatefulSet 创建 Pod 时，控制平面会在该 Pod 上设置此标签。
172+
标签的值是正在创建的 Pod 的名称。
173+
174+
更多细节请参见 StatefulSet 文章中的 [Pod 名称标签](/zh/docs/concepts/workloads/controllers/statefulset/#pod-name-label)。
175+
127176
## topology.kubernetes.io/region {#topologykubernetesioregion}
128177

129178
示例
@@ -316,6 +365,17 @@ Starting in v1.18, this annotation is deprecated in favor of `spec.ingressClassN
316365
从 v1.18 开始，此注解被弃用，取而代之的是 `spec.ingressClassName`。
317366
{{< /note >}}
318367

368+
## storageclass.kubernetes.io/is-default-class
369+
370+
示例：`storageclass.kubernetes.io/is-default-class=true`
371+
372+
用于：StorageClass
373+
374+
<!--
375+
When a single StorageClass resource has this annotation set to `"true"`, new Physical Volume Claim resource without a class specified will be assigned this default class.
376+
-->
377+
当单个的 StorageClass 资源将这个注解设置为 `"true"` 时，新的持久卷申领（PVC）
378+
资源若未指定类别，将被设定为此默认类别。
319379

320380
## alpha.kubernetes.io/provided-node-ip
321381

@@ -327,14 +387,50 @@ Starting in v1.18, this annotation is deprecated in favor of `spec.ingressClassN
327387
The kubelet can set this annotation on a Node to denote its configured IPv4 address.
328388
329389
When kubelet is started with the "external" cloud provider, it sets this annotation on the Node to denote an IP address set from the command line flag (`--node-ip`). This IP is verified with the cloud provider as valid by the cloud-controller-manager.
330-
331-
**The taints listed below are always used on Nodes**
332390
-->
333391
kubectl 在 Node 上设置此注解，表示它的 IPv4 地址。
334392

335393
当 kubectl 由外部的云供应商启动时，在 Node 上设置此注解，表示由命令行标记(`--node-ip`)设置的 IP 地址。
336394
cloud-controller-manager 向云供应商验证此 IP 是否有效。
337395

396+
## batch.kubernetes.io/job-completion-index
397+
398+
示例：`batch.kubernetes.io/job-completion-index: "3"`
399+
400+
用于：Pod
401+
402+
<!--
403+
The Job controller in the kube-controller-manager sets this annotation for Pods
404+
created with Indexed [completion mode](/docs/concepts/workloads/controllers/job/#completion-mode).
405+
-->
406+
kube-controller-manager 中的 Job 控制器给创建使用索引
407+
[完成模式](/zh/docs/concepts/workloads/controllers/job/#completion-mode)
408+
的 Pod 设置此注解。
409+
410+
## kubectl.kubernetes.io/default-container
411+
412+
示例：`kubectl.kubernetes.io/default-container: "front-end-app"`
413+
414+
<!--
415+
The value of the annotation is the container name that is default for this Pod. For example, `kubectl logs` or `kubectl exec` without `-c` or `--container` flag will use this default container.
416+
-->
417+
注解的值是此 Pod 的默认容器名称。
418+
例如，`kubectl logs` 或 `kubectl exec` 没有 `-c` 或 `--container` 参数时，将使用这个默认的容器。
419+
420+
## endpoints.kubernetes.io/over-capacity
421+
422+
示例：`endpoints.kubernetes.io/over-capacity:warning`
423+
424+
用于：Endpoints
425+
426+
<!--
427+
In Kubernetes clusters v1.21 (or later), the Endpoints controller adds this annotation to an Endpoints resource if it has more than 1000 endpoints. The annotation indicates that the Endpoints resource is over capacity.
428+
429+
**The taints listed below are always used on Nodes**
430+
-->
431+
在 Kubernetes 集群 v1.21（或更高版本）中，如果 Endpoint 超过 1000 个，Endpoint 控制器
432+
就会向其添加这个注解。该注解表示 Endpoint 资源已超过容量。
433+
338434
**以下列出的污点只能用于 Node**
339435

340436
## node.kubernetes.io/not-ready

0 commit comments

Comments
 (0)