Skip to content

Commit 279a835

Browse files
committed
sync volume-pvc-datasource volume-snapshot-classes topology-spread-constraints security-checklist
1 parent 5113c90 commit 279a835

File tree

4 files changed

+40
-15
lines changed

4 files changed

+40
-15
lines changed

content/zh-cn/docs/concepts/scheduling-eviction/topology-spread-constraints.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -415,7 +415,7 @@ confusing and troubleshooting is less straightforward.
415415
You need a mechanism to ensure that all the nodes in a topology domain (such as a
416416
cloud provider region) are labelled consistently.
417417
To avoid you needing to manually label nodes, most clusters automatically
418-
populate well-known labels such as `topology.kubernetes.io/hostname`. Check whether
418+
populate well-known labels such as `kubernetes.io/hostname`. Check whether
419419
your cluster supports this.
420420
-->
421421
## 一致性 {#Consistency}
@@ -428,7 +428,7 @@ your cluster supports this.
428428
429429
你需要一种机制来确保拓扑域(例如云提供商区域)中的所有节点具有一致的标签。
430430
为了避免你需要手动为节点打标签,大多数集群会自动填充知名的标签,
431-
例如 `topology.kubernetes.io/hostname`。检查你的集群是否支持此功能。
431+
例如 `kubernetes.io/hostname`。检查你的集群是否支持此功能。
432432
433433
<!--
434434
## Topology spread constraint examples

content/zh-cn/docs/concepts/security/security-checklist.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -775,6 +775,8 @@ has permissions to use the image.
775775
776776
- [RBAC Good Practices](/docs/concepts/security/rbac-good-practices/) for
777777
further information on authorization.
778+
- [Securing a Cluster](/docs/tasks/administer-cluster/securing-a-cluster/) for
779+
information on protecting a cluster from accidental or malicious access.
778780
- [Cluster Multi-tenancy guide](/docs/concepts/security/multi-tenancy/) for
779781
configuration options recommendations and best practices on multi-tenancy.
780782
- [Blog post "A Closer Look at NSA/CISA Kubernetes Hardening Guidance"](/blog/2021/10/05/nsa-cisa-kubernetes-hardening-guidance/#building-secure-container-images)
@@ -783,6 +785,7 @@ has permissions to use the image.
783785
## 接下来 {#what-is-next}
784786

785787
- [RBAC 良好实践](/zh-cn/docs/concepts/security/rbac-good-practices/)提供有关授权的更多信息。
788+
- [保护集群](/zh-cn/docs/tasks/administer-cluster/securing-a-cluster/)提供如何保护集群免受意外或恶意访问的信息。
786789
- [集群多租户指南](/zh-cn/docs/concepts/security/multi-tenancy/)提供有关多租户的配置选项建议和最佳实践。
787790
- [博文“深入了解 NSA/CISA Kubernetes 强化指南”](/blog/2021/10/05/nsa-cisa-kubernetes-hardening-guidance/#building-secure-container-images)为强化
788791
Kubernetes 集群提供补充资源。

content/zh-cn/docs/concepts/storage/volume-pvc-datasource.md

Lines changed: 26 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,8 @@ weight: 60
1818
<!-- overview -->
1919

2020
<!--
21-
This document describes the concept of cloning existing CSI Volumes in Kubernetes. Familiarity with [Volumes](/docs/concepts/storage/volumes) is suggested.
21+
This document describes the concept of cloning existing CSI Volumes in Kubernetes.
22+
Familiarity with [Volumes](/docs/concepts/storage/volumes) is suggested.
2223
-->
2324
本文档介绍 Kubernetes 中克隆现有 CSI 卷的概念。阅读前建议先熟悉
2425
[](/zh-cn/docs/concepts/storage/volumes)
@@ -28,7 +29,9 @@ This document describes the concept of cloning existing CSI Volumes in Kubernete
2829
<!--
2930
## Introduction
3031
31-
The {{< glossary_tooltip text="CSI" term_id="csi" >}} Volume Cloning feature adds support for specifying existing {{< glossary_tooltip text="PVC" term_id="persistent-volume-claim" >}}s in the `dataSource` field to indicate a user would like to clone a {{< glossary_tooltip term_id="volume" >}}.
32+
The {{< glossary_tooltip text="CSI" term_id="csi" >}} Volume Cloning feature adds
33+
support for specifying existing {{< glossary_tooltip text="PVC" term_id="persistent-volume-claim" >}}s
34+
in the `dataSource` field to indicate a user would like to clone a {{< glossary_tooltip term_id="volume" >}}.
3235
-->
3336
## 介绍
3437

@@ -38,13 +41,18 @@ The {{< glossary_tooltip text="CSI" term_id="csi" >}} Volume Cloning feature add
3841
来表示用户想要克隆的 {{< glossary_tooltip term_id="volume" >}}。
3942

4043
<!--
41-
A Clone is defined as a duplicate of an existing Kubernetes Volume that can be consumed as any standard Volume would be. The only difference is that upon provisioning, rather than creating a "new" empty Volume, the back end device creates an exact duplicate of the specified Volume.
44+
A Clone is defined as a duplicate of an existing Kubernetes Volume that can be
45+
consumed as any standard Volume would be. The only difference is that upon
46+
provisioning, rather than creating a "new" empty Volume, the back end device
47+
creates an exact duplicate of the specified Volume.
4248
-->
4349
克隆(Clone),意思是为已有的 Kubernetes 卷创建副本,它可以像任何其它标准卷一样被使用。
4450
唯一的区别就是配置后,后端设备将创建指定完全相同的副本,而不是创建一个“新的”空卷。
4551

4652
<!--
47-
The implementation of cloning, from the perspective of the Kubernetes API, adds the ability to specify an existing PVC as a dataSource during new PVC creation. The source PVC must be bound and available (not in use).
53+
The implementation of cloning, from the perspective of the Kubernetes API, adds
54+
the ability to specify an existing PVC as a dataSource during new PVC creation.
55+
The source PVC must be bound and available (not in use).
4856
4957
Users need to be aware of the following when using this feature:
5058
-->
@@ -58,11 +66,13 @@ Users need to be aware of the following when using this feature:
5866
* Cloning support (`VolumePVCDataSource`) is only available for CSI drivers.
5967
* Cloning support is only available for dynamic provisioners.
6068
* CSI drivers may or may not have implemented the volume cloning functionality.
61-
* You can only clone a PVC when it exists in the same namespace as the destination PVC (source and destination must be in the same namespace).
69+
* You can only clone a PVC when it exists in the same namespace as the destination PVC
70+
(source and destination must be in the same namespace).
6271
* Cloning is supported with a different Storage Class.
6372
- Destination volume can be the same or a different storage class as the source.
6473
- Default storage class can be used and storageClassName omitted in the spec.
65-
* Cloning can only be performed between two volumes that use the same VolumeMode setting (if you request a block mode volume, the source MUST also be block mode)
74+
* Cloning can only be performed between two volumes that use the same VolumeMode setting
75+
(if you request a block mode volume, the source MUST also be block mode)
6676
-->
6777
* 克隆支持(`VolumePVCDataSource`)仅适用于 CSI 驱动。
6878
* 克隆支持仅适用于 动态供应器。
@@ -103,21 +113,27 @@ spec:
103113
104114
{{< note >}}
105115
<!--
106-
You must specify a capacity value for `spec.resources.requests.storage`,
107-
and the value you specify must be the same or larger than the capacity of the source volume.
116+
You must specify a capacity value for `spec.resources.requests.storage`, and the
117+
value you specify must be the same or larger than the capacity of the source volume.
108118
-->
109119
你必须为 `spec.resources.requests.storage` 指定一个值,并且你指定的值必须大于或等于源卷的值。
110120
{{< /note >}}
111121

112122
<!--
113-
The result is a new PVC with the name `clone-of-pvc-1` that has the exact same content as the specified source `pvc-1`.
123+
The result is a new PVC with the name `clone-of-pvc-1` that has the exact same
124+
content as the specified source `pvc-1`.
114125
-->
115126
结果是一个名称为 `clone-of-pvc-1` 的新 PVC 与指定的源 `pvc-1` 拥有相同的内容。
116127

117128
<!--
118129
## Usage
119130

120-
Upon availability of the new PVC, the cloned PVC is consumed the same as other PVC. It's also expected at this point that the newly created PVC is an independent object. It can be consumed, cloned, snapshotted, or deleted independently and without consideration for it's original dataSource PVC. This also implies that the source is not linked in any way to the newly created clone, it may also be modified or deleted without affecting the newly created clone.
131+
Upon availability of the new PVC, the cloned PVC is consumed the same as other PVC.
132+
It's also expected at this point that the newly created PVC is an independent object.
133+
It can be consumed, cloned, snapshotted, or deleted independently and without
134+
consideration for it's original dataSource PVC. This also implies that the source
135+
is not linked in any way to the newly created clone, it may also be modified or
136+
deleted without affecting the newly created clone.
121137
-->
122138
## 使用
123139

content/zh-cn/docs/concepts/storage/volume-snapshot-classes.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,8 @@ of a class when first creating VolumeSnapshotClass objects, and the objects cann
4343
be updated once they are created.
4444
4545
{{< note >}}
46-
Installation of the CRDs is the responsibility of the Kubernetes distribution. Without the required CRDs present, the creation of a VolumeSnapshotClass fails.
46+
Installation of the CRDs is the responsibility of the Kubernetes distribution.
47+
Without the required CRDs present, the creation of a VolumeSnapshotClass fails.
4748
{{< /note >}}
4849
4950
-->
@@ -104,9 +105,14 @@ used for provisioning VolumeSnapshots. This field must be specified.
104105
<!--
105106
### DeletionPolicy
106107
107-
Volume snapshot classes have a deletionPolicy. It enables you to configure what happens to a VolumeSnapshotContent when the VolumeSnapshot object it is bound to is to be deleted. The deletionPolicy of a volume snapshot class can either be `Retain` or `Delete`. This field must be specified.
108+
Volume snapshot classes have a deletionPolicy. It enables you to configure what
109+
happens to a VolumeSnapshotContent when the VolumeSnapshot object it is bound to
110+
is to be deleted. The deletionPolicy of a volume snapshot class can either be
111+
`Retain` or `Delete`. This field must be specified.
108112

109-
If the deletionPolicy is `Delete`, then the underlying storage snapshot will be deleted along with the VolumeSnapshotContent object. If the deletionPolicy is `Retain`, then both the underlying snapshot and VolumeSnapshotContent remain.
113+
If the deletionPolicy is `Delete`, then the underlying storage snapshot will be
114+
deleted along with the VolumeSnapshotContent object. If the deletionPolicy is `Retain`,
115+
then both the underlying snapshot and VolumeSnapshotContent remain.
110116
-->
111117
### 删除策略 {#deletion-policy}
112118

0 commit comments

Comments
 (0)