Skip to content

Commit 07df8ad

Browse files
authored
Merge pull request #34828 from windsonsea/template
[zh-cn] Improve concepts/workloads/pods/_index.md
2 parents 3584ae3 + 4220852 commit 07df8ad

File tree

1 file changed

+55
-61
lines changed
  • content/zh-cn/docs/concepts/workloads/pods

1 file changed

+55
-61
lines changed

content/zh-cn/docs/concepts/workloads/pods/_index.md

Lines changed: 55 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Pods
2+
title: Pod
33
content_type: concept
44
weight: 10
55
no_list: true
@@ -33,16 +33,15 @@ application-specific "logical host": it contains one or more application
3333
containers which are relatively tightly coupled.
3434
In non-cloud contexts, applications executed on the same physical or virtual machine are analogous to cloud applications executed on the same logical host.
3535
-->
36-
_Pod_ 是可以在 Kubernetes 中创建和管理的、最小的可部署的计算单元。
36+
**Pod** 是可以在 Kubernetes 中创建和管理的、最小的可部署的计算单元。
3737

38-
_Pod_ (就像在鲸鱼荚或者豌豆荚中)是一组(一个或多个)
38+
**Pod**(就像在鲸鱼荚或者豌豆荚中)是一组(一个或多个)
3939
{{< glossary_tooltip text="容器" term_id="container" >}};
4040
这些容器共享存储、网络、以及怎样运行这些容器的声明。
4141
Pod 中的内容总是并置(colocated)的并且一同调度,在共享的上下文中运行。
42-
Pod 所建模的是特定于应用的“逻辑主机”,其中包含一个或多个应用容器,
43-
这些容器是相对紧密的耦合在一起的。
44-
在非云环境中,在相同的物理机或虚拟机上运行的应用类似于
45-
在同一逻辑主机上运行的云应用。
42+
Pod 所建模的是特定于应用的 “逻辑主机”,其中包含一个或多个应用容器,
43+
这些容器相对紧密地耦合在一起。
44+
在非云环境中,在相同的物理机或虚拟机上运行的应用类似于在同一逻辑主机上运行的云应用。
4645

4746
<!--
4847
As well as application containers, a Pod can contain
@@ -82,12 +81,11 @@ further sub-isolations applied.
8281
In terms of Docker concepts, a Pod is similar to a group of Docker containers
8382
with shared namespaces and shared filesystem volumes.
8483
-->
85-
Pod 的共享上下文包括一组 Linux 名字空间、控制组(cgroup)和可能一些其他的隔离
86-
方面,即用来隔离 Docker 容器的技术。
84+
Pod 的共享上下文包括一组 Linux 名字空间、控制组(cgroup)和可能一些其他的隔离方面,
85+
即用来隔离 Docker 容器的技术。
8786
在 Pod 的上下文中,每个独立的应用可能会进一步实施隔离。
8887

89-
就 Docker 概念的术语而言,Pod 类似于共享名字空间和文件系统卷的一组 Docker
90-
容器。
88+
就 Docker 概念的术语而言,Pod 类似于共享名字空间和文件系统卷的一组 Docker 容器。
9189

9290
<!--
9391
## Using Pods
@@ -118,7 +116,7 @@ with workload resources.
118116
### Workload resources for managing pods
119117
-->
120118
Pod 通常不是直接创建的,而是使用工作负载资源创建的。
121-
有关如何将 Pod 用于工作负载资源的更多信息,请参阅 [使用 Pod](#working-with-pods)
119+
有关如何将 Pod 用于工作负载资源的更多信息,请参阅[使用 Pod](#working-with-pods)
122120

123121
### 用于管理 pod 的工作负载资源
124122

@@ -134,10 +132,9 @@ Pods in a Kubernetes cluster are used in two main ways:
134132
通常你不需要直接创建 Pod,甚至单实例 Pod。
135133
相反,你会使用诸如
136134
{{< glossary_tooltip text="Deployment" term_id="deployment" >}} 或
137-
{{< glossary_tooltip text="Job" term_id="job" >}} 这类工作负载资源
138-
来创建 Pod。如果 Pod 需要跟踪状态,
139-
可以考虑 {{< glossary_tooltip text="StatefulSet" term_id="statefulset" >}}
140-
资源。
135+
{{< glossary_tooltip text="Job" term_id="job" >}} 这类工作负载资源来创建 Pod。
136+
如果 Pod 需要跟踪状态,可以考虑
137+
{{< glossary_tooltip text="StatefulSet" term_id="statefulset" >}} 资源。
141138

142139
Kubernetes 集群中的 Pod 主要有两种用法:
143140

@@ -159,12 +156,12 @@ Kubernetes 集群中的 Pod 主要有两种用法:
159156
relatively advanced use case. You should use this pattern only in specific
160157
instances in which your containers are tightly coupled.
161158
-->
162-
* **运行单个容器的 Pod**。"每个 Pod 一个容器"模型是最常见的 Kubernetes 用例;
159+
* **运行单个容器的 Pod**。"每个 Pod 一个容器" 模型是最常见的 Kubernetes 用例;
163160
在这种情况下,可以将 Pod 看作单个容器的包装器,并且 Kubernetes 直接管理 Pod,而不是容器。
164161
* **运行多个协同工作的容器的 Pod**
165162
Pod 可能封装由多个紧密耦合且需要共享资源的共处容器组成的应用程序。
166163
这些位于同一位置的容器可能形成单个内聚的服务单元 —— 一个容器将文件从共享卷提供给公众,
167-
而另一个单独的“边车”(sidecar)容器则刷新或更新这些文件。
164+
而另一个单独的 “边车”(sidecar)容器则刷新或更新这些文件。
168165
Pod 将这些容器和存储资源打包为一个可管理的实体。
169166

170167
{{< note >}}
@@ -185,9 +182,9 @@ Kubernetes uses workload resources, and their controllers, to implement applicat
185182
scaling and auto-healing.
186183
-->
187184

188-
每个 Pod 都旨在运行给定应用程序的单个实例。如果希望横向扩展应用程序(例如,运行多个实例
189-
以提供更多的资源),则应该使用多个 Pod,每个实例使用一个 Pod。
190-
在 Kubernetes 中,这通常被称为 _副本(Replication)_
185+
每个 Pod 都旨在运行给定应用程序的单个实例。如果希望横向扩展应用程序
186+
(例如,运行多个实例以提供更多的资源),则应该使用多个 Pod,每个实例使用一个 Pod。
187+
在 Kubernetes 中,这通常被称为**副本(Replication)**
191188
通常使用一种工作负载资源及其{{< glossary_tooltip text="控制器" term_id="controller" >}}
192189
来创建和管理一组 Pod 副本。
193190

@@ -218,7 +215,7 @@ that updates those files from a remote source, as in the following diagram:
218215
例如,你可能有一个容器,为共享卷中的文件提供 Web 服务器支持,以及一个单独的
219216
"边车 (sidercar)" 容器负责从远端更新这些文件,如下图所示:
220217

221-
{{< figure src="/images/docs/pod.svg" alt="Pod creation diagram" class="diagram-medium" >}}
218+
{{< figure src="/images/docs/pod.svg" alt="Pod 创建示意图" class="diagram-medium" >}}
222219

223220
<!--
224221
Some Pods have {{< glossary_tooltip text="init containers" term_id="init-container" >}}
@@ -228,12 +225,11 @@ Init containers run and complete before the app containers are started.
228225
Pods natively provide two kinds of shared resources for their constituent containers:
229226
[networking](#pod-networking) and [storage](#pod-storage).
230227
-->
231-
有些 Pod 具有 {{< glossary_tooltip text="Init 容器" term_id="init-container" >}}
228+
有些 Pod 具有 {{< glossary_tooltip text="Init 容器" term_id="init-container" >}}和
232229
{{< glossary_tooltip text="应用容器" term_id="app-container" >}}。
233230
Init 容器会在启动应用容器之前运行并完成。
234231

235-
Pod 天生地为其成员容器提供了两种共享资源:[网络](#pod-networking)
236-
[存储](#pod-storage)
232+
Pod 天生地为其成员容器提供了两种共享资源:[网络](#pod-networking)[存储](#pod-storage)
237233

238234
<!--
239235
## Working with Pods
@@ -250,10 +246,9 @@ the Pod is *evicted* for lack of resources, or the node fails.
250246

251247
你很少在 Kubernetes 中直接创建一个个的 Pod,甚至是单实例(Singleton)的 Pod。
252248
这是因为 Pod 被设计成了相对临时性的、用后即抛的一次性实体。
253-
当 Pod 由你或者间接地由 {{< glossary_tooltip text="控制器" term_id="controller" >}}
249+
当 Pod 由你或者间接地由{{< glossary_tooltip text="控制器" term_id="controller" >}}
254250
创建时,它被调度在集群中的{{< glossary_tooltip text="节点" term_id="node" >}}上运行。
255-
Pod 会保持在该节点上运行,直到 Pod 结束执行、Pod 对象被删除、Pod 因资源不足而被
256-
*驱逐* 或者节点失效为止。
251+
Pod 会保持在该节点上运行,直到 Pod 结束执行、Pod 对象被删除、Pod 因资源不足而被**驱逐**或者节点失效为止。
257252

258253
<!--
259254
Restarting a container in a Pod should not be confused with restarting a Pod. A Pod
@@ -308,10 +303,10 @@ PodTemplates are specifications for creating Pods, and are included in workload
308303
[Jobs](/docs/concepts/workloads/controllers/job/), and
309304
[DaemonSets](/docs/concepts/workloads/controllers/daemonset/).
310305
-->
311-
### Pod 模版 {#pod-templates}
306+
### Pod 模板 {#pod-templates}
312307

313308
{{< glossary_tooltip text="负载" term_id="workload" >}}资源的控制器通常使用
314-
_Pod 模板(Pod Template)_ 来替你创建 Pod 并管理它们。
309+
**Pod 模板(Pod Template)**来替你创建 Pod 并管理它们。
315310

316311
Pod 模板是包含在工作负载对象中的规范,用来创建 Pod。这类负载资源包括
317312
[Deployment](/zh-cn/docs/concepts/workloads/controllers/deployment/)
@@ -339,14 +334,14 @@ metadata:
339334
name: hello
340335
spec:
341336
template:
342-
# 这里是 Pod 模版
337+
# 这里是 Pod 模板
343338
spec:
344339
containers:
345340
- name: hello
346341
image: busybox:1.28
347342
command: ['sh', '-c', 'echo "Hello, Kubernetes!" && sleep 3600']
348343
restartPolicy: OnFailure
349-
# 以上为 Pod 模版
344+
# 以上为 Pod 模板
350345
```
351346

352347
<!--
@@ -359,13 +354,13 @@ pod template for each Deployment object. If the template is updated, the Deploym
359354
to remove the existing Pods and create new Pods based on the updated template. Each workload
360355
resource implements its own rules for handling changes to the Pod template.
361356
-->
362-
修改 Pod 模版或者切换到新的 Pod 模版都不会对已经存在的 Pod 起作用。
363-
Pod 不会直接收到模版的更新。相反,
364-
新的 Pod 会被创建出来,与更改后的 Pod 模版匹配
357+
修改 Pod 模板或者切换到新的 Pod 模板都不会对已经存在的 Pod 起作用。
358+
Pod 不会直接收到模板的更新。相反,
359+
新的 Pod 会被创建出来,与更改后的 Pod 模板匹配
365360

366361
例如,Deployment 控制器针对每个 Deployment 对象确保运行中的 Pod 与当前的 Pod
367-
模版匹配。如果模版被更新,则 Deployment 必须删除现有的 Pod,基于更新后的模版
368-
创建新的 Pod。每个工作负载资源都实现了自己的规则,用来处理对 Pod 模版的更新
362+
模板匹配。如果模板被更新,则 Deployment 必须删除现有的 Pod,基于更新后的模板创建新的 Pod。
363+
每个工作负载资源都实现了自己的规则,用来处理对 Pod 模板的更新
369364

370365
<!--
371366
On Nodes, the {{< glossary_tooltip term_id="kubelet" text="kubelet" >}} does not
@@ -375,9 +370,9 @@ system semantics, and makes it feasible to extend the cluster's behavior without
375370
changing existing code.
376371
-->
377372
在节点上,{{< glossary_tooltip term_id="kubelet" text="kubelet" >}} 并不直接监测
378-
或管理与 Pod 模版相关的细节或模版的更新,这些细节都被抽象出来。
379-
这种抽象和关注点分离简化了整个系统的语义,并且使得用户可以在不改变现有代码的
380-
前提下就能扩展集群的行为
373+
或管理与 Pod 模板相关的细节或模板的更新,这些细节都被抽象出来。
374+
这种抽象和关注点分离简化了整个系统的语义,
375+
并且使得用户可以在不改变现有代码的前提下就能扩展集群的行为
381376

382377
<!--
383378
## Pod update and replacement
@@ -388,8 +383,8 @@ template instead of updating or patching the existing Pods.
388383
-->
389384
## Pod 更新与替换 {#pod-update-and-replacement}
390385

391-
正如前面章节所述,当某工作负载的 Pod 模板被改变时,控制器会基于更新的模板
392-
创建新的 Pod 对象而不是对现有 Pod 执行更新或者修补操作。
386+
正如前面章节所述,当某工作负载的 Pod 模板被改变时,
387+
控制器会基于更新的模板创建新的 Pod 对象而不是对现有 Pod 执行更新或者修补操作。
393388

394389
<!--
395390
Kubernetes doesn't prevent you from managing Pods directly. It is possible to
@@ -423,8 +418,8 @@ Kubernetes 并不禁止你直接管理 Pod。对运行中的 Pod 的某些字段
423418
number.
424419
-->
425420
- Pod 的绝大多数元数据都是不可变的。例如,你不可以改变其 `namespace``name`
426-
`uid` 或者 `creationTimestamp` 字段;`generation` 字段是比较特别的,如果更新
427-
该字段,只能增加字段取值而不能减少。
421+
`uid` 或者 `creationTimestamp` 字段;`generation` 字段是比较特别的,
422+
如果更新该字段,只能增加字段取值而不能减少。
428423
- 如果 `metadata.deletionTimestamp` 已经被设置,则不可以向 `metadata.finalizers`
429424
列表中添加新的条目。
430425
- Pod 更新不可以改变除 `spec.containers[*].image``spec.initContainers[*].image`
@@ -478,9 +473,8 @@ they must coordinate how they use the shared network resources (such as ports).
478473

479474
每个 Pod 都在每个地址族中获得一个唯一的 IP 地址。
480475
Pod 中的每个容器共享网络名字空间,包括 IP 地址和网络端口。
481-
*Pod 内* 的容器可以使用 `localhost` 互相通信。
482-
当 Pod 中的容器与 *Pod 之外* 的实体通信时,它们必须协调如何使用共享的网络资源
483-
(例如端口)。
476+
**Pod 内**的容器可以使用 `localhost` 互相通信。
477+
当 Pod 中的容器与 **Pod 之外**的实体通信时,它们必须协调如何使用共享的网络资源(例如端口)。
484478

485479
<!--
486480
Within a Pod, containers share an IP address and port space, and
@@ -517,8 +511,7 @@ If your cluster has the `WindowsHostProcessContainers` feature enabled, you can
517511
在 Linux 中,Pod 中的任何容器都可以使用容器规约中的
518512
[安全性上下文](/zh-cn/docs/tasks/configure-pod-container/security-context/)中的
519513
`privileged`(Linux)参数启用特权模式。
520-
这对于想要使用操作系统管理权能(Capabilities,如操纵网络堆栈和访问设备)
521-
的容器很有用。
514+
这对于想要使用操作系统管理权能(Capabilities,如操纵网络堆栈和访问设备)的容器很有用。
522515

523516
如果你的集群启用了 `WindowsHostProcessContainers` 特性,你可以使用 Pod 规约中安全上下文的
524517
`windowsOptions.hostProcess` 参数来创建
@@ -530,8 +523,8 @@ HostProcess Pod 可以直接运行在主机上,它也能像 Linux 特权容器
530523
Your {{< glossary_tooltip text="container runtime" term_id="container-runtime" >}} must support the concept of a privileged container for this setting to be relevant.
531524
-->
532525
{{< note >}}
533-
你的{{< glossary_tooltip text="容器运行时" term_id="container-runtime" >}}必须支持
534-
特权容器的概念才能使用这一配置
526+
你的{{< glossary_tooltip text="容器运行时" term_id="container-runtime" >}}
527+
必须支持特权容器的概念才能使用这一配置
535528
{{< /note >}}
536529

537530
<!--
@@ -546,8 +539,8 @@ Pods, the kubelet directly supervises each static Pod (and restarts it if it fai
546539
-->
547540
## 静态 Pod {#static-pods}
548541

549-
_静态 Pod(Static Pod)_ 直接由特定节点上的 `kubelet` 守护进程管理,
550-
不需要{{< glossary_tooltip text="API 服务器" term_id="kube-apiserver" >}}看到它们。
542+
**静态 Pod(Static Pod)**直接由特定节点上的 `kubelet` 守护进程管理,
543+
不需要 {{< glossary_tooltip text="API 服务器" term_id="kube-apiserver" >}}看到它们。
551544
尽管大多数 Pod 都是通过控制面(例如,{{< glossary_tooltip text="Deployment" term_id="deployment" >}})
552545
来管理的,对于静态 Pod 而言,`kubelet` 直接监控每个 Pod,并在其失效时重启之。
553546

@@ -568,8 +561,7 @@ but cannot be controlled from there.
568561

569562
`kubelet` 自动尝试为每个静态 Pod 在 Kubernetes API 服务器上创建一个
570563
{{< glossary_tooltip text="镜像 Pod" term_id="mirror-pod" >}}。
571-
这意味着在节点上运行的 Pod 在 API 服务器上是可见的,但不可以通过 API
572-
服务器来控制。
564+
这意味着在节点上运行的 Pod 在 API 服务器上是可见的,但不可以通过 API 服务器来控制。
573565

574566
{{< note >}}
575567
<!--
@@ -578,7 +570,10 @@ The `spec` of a static Pod cannot refer to other API objects
578570
{{< glossary_tooltip text="ConfigMap" term_id="configmap" >}},
579571
{{< glossary_tooltip text="Secret" term_id="secret" >}}, etc).
580572
-->
581-
静态 Pod 的 `spec` 不能引用其他的 API 对象(例如:{{< glossary_tooltip text="ServiceAccount" term_id="service-account" >}}、{{< glossary_tooltip text="ConfigMap" term_id="configmap" >}}、{{< glossary_tooltip text="Secret" term_id="secret" >}}等)。
573+
静态 Pod 的 `spec` 不能引用其他的 API 对象(例如:
574+
{{< glossary_tooltip text="ServiceAccount" term_id="service-account" >}}、
575+
{{< glossary_tooltip text="ConfigMap" term_id="configmap" >}}、
576+
{{< glossary_tooltip text="Secret" term_id="secret" >}} 等)。
582577
{{< /note >}}
583578

584579
<!--
@@ -595,7 +590,7 @@ in the Pod Lifecycle documentation.
595590
-->
596591
## 容器探针 {#container-probes}
597592

598-
_Probe_ 是由 kubelet 对容器执行的定期诊断。要执行诊断,kubelet 可以执行三种动作:
593+
**Probe** 是由 kubelet 对容器执行的定期诊断。要执行诊断,kubelet 可以执行三种动作:
599594

600595
- `ExecAction`(借助容器运行时执行)
601596
- `TCPSocketAction`(由 kubelet 直接检测)
@@ -616,10 +611,10 @@ _Probe_ 是由 kubelet 对容器执行的定期诊断。要执行诊断,kubele
616611
object definition describes the object in detail.
617612
* [The Distributed System Toolkit: Patterns for Composite Containers](/blog/2015/06/the-distributed-system-toolkit-patterns/) explains common layouts for Pods with more than one container.
618613
-->
619-
* 了解 [Pod 生命周期](/zh-cn/docs/concepts/workloads/pods/pod-lifecycle/)
614+
* 了解 [Pod 生命周期](/zh-cn/docs/concepts/workloads/pods/pod-lifecycle/)
620615
* 了解 [RuntimeClass](/zh-cn/docs/concepts/containers/runtime-class/),以及如何使用它
621-
来配置不同的 Pod 使用不同的容器运行时配置
622-
* 了解 [Pod 拓扑分布约束](/zh-cn/docs/concepts/workloads/pods/pod-topology-spread-constraints/)
616+
来配置不同的 Pod 使用不同的容器运行时配置
617+
* 了解 [Pod 拓扑分布约束](/zh-cn/docs/concepts/workloads/pods/pod-topology-spread-constraints/)
623618
* 了解 [PodDisruptionBudget](/zh-cn/docs/concepts/workloads/pods/disruptions/),以及你
624619
如何可以利用它在出现干扰因素时管理应用的可用性。
625620
* Pod 在 Kubernetes REST API 中是一个顶层资源。
@@ -641,4 +636,3 @@ To understand the context for why Kubernetes wraps a common Pod API in other res
641636
* [Marathon](https://mesosphere.github.io/marathon/docs/rest-api.html)
642637
* [Omega](https://research.google/pubs/pub41684/)
643638
* [Tupperware](https://engineering.fb.com/data-center-engineering/tupperware/).
644-

0 commit comments

Comments
 (0)