Skip to content

Commit 5030229

Browse files
authored
Update volume-snapshots.md
[zh] update content to match en master
1 parent 839873d commit 5030229

File tree

1 file changed

+25
-13
lines changed

1 file changed

+25
-13
lines changed

content/zh/docs/concepts/storage/volume-snapshots.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ A `VolumeSnapshot` is a request for snapshot of a volume by a user. It is simila
4444
`VolumeSnapshot` 是用户对于卷的快照的请求。它类似于持久卷声明。
4545

4646
<!--
47-
`VolumeSnapshotClass` allows you to specify different attributes belonging to a `VolumeSnapshot`. These attibutes may differ among snapshots taken from the same volume on the storage system and therefore cannot be expressed by using the same `StorageClass` of a `PersistentVolumeClaim`.
47+
`VolumeSnapshotClass` allows you to specify different attributes belonging to a `VolumeSnapshot`. These attributes may differ among snapshots taken from the same volume on the storage system and therefore cannot be expressed by using the same `StorageClass` of a `PersistentVolumeClaim`.
4848
-->
4949
`VolumeSnapshotClass` 允许指定属于 `VolumeSnapshot` 的不同属性。在从存储系统的相同卷上获取的快照之间,这些属性可能有所不同,因此不能通过使用与 `PersistentVolumeClaim` 相同的 `StorageClass` 来表示。
5050

@@ -63,14 +63,26 @@ Users need to be aware of the following when using this feature:
6363
<!--
6464
* API Objects `VolumeSnapshot`, `VolumeSnapshotContent`, and `VolumeSnapshotClass` are {{< glossary_tooltip term_id="CustomResourceDefinition" text="CRDs" >}}, not part of the core API.
6565
* `VolumeSnapshot` support is only available for CSI drivers.
66-
* As part of the deployment process in the beta version of `VolumeSnapshot`, the Kubernetes team provides a snapshot controller to be deployed into the control plane, and a sidecar helper container called csi-snapshotter to be deployed together with the CSI driver. The snapshot controller watches `VolumeSnapshot` and `VolumeSnapshotContent` objects and is responsible for the creation and deletion of `VolumeSnapshotContent` object in dynamic provisioning. The sidecar csi-snapshotter watches `VolumeSnapshotContent` objects and triggers `CreateSnapshot` and `DeleteSnapshot` operations against a CSI endpoint.
66+
* As part of the deployment process of `VolumeSnapshot`, the Kubernetes team provides a snapshot controller to be deployed into the control plane, and a sidecar helper container called csi-snapshotter to be deployed together with the CSI driver. The snapshot controller watches `VolumeSnapshot` and `VolumeSnapshotContent` objects and is responsible for the creation and deletion of `VolumeSnapshotContent` object. The sidecar csi-snapshotter watches `VolumeSnapshotContent` objects and triggers `CreateSnapshot` and `DeleteSnapshot` operations against a CSI endpoint.
67+
* There is also a validating webhook server which provides tightened validation on snapshot objects. This should be installed by the Kubernetes distros along with the snapshot controller and CRDs, not CSI drivers. It should be installed in all Kubernetes clusters that has the snapshot feature enabled.
6768
* CSI drivers may or may not have implemented the volume snapshot functionality. The CSI drivers that have provided support for volume snapshot will likely use the csi-snapshotter. See [CSI Driver documentation](https://kubernetes-csi.github.io/docs/) for details.
6869
* The CRDs and snapshot controller installations are the responsibility of the Kubernetes distribution.
6970
-->
70-
* API 对象 `VolumeSnapshot``VolumeSnapshotContent``VolumeSnapshotClass` 是 {{< glossary_tooltip term_id="CustomResourceDefinition" text="CRDs" >}},不是核心 API 的部分。
71+
* API 对象 `VolumeSnapshot``VolumeSnapshotContent``VolumeSnapshotClass`
72+
是 {{< glossary_tooltip term_id="CustomResourceDefinition" text="CRDs" >}},
73+
不是核心 API 的部分。
7174
* `VolumeSnapshot` 支持仅可用于 CSI 驱动。
72-
* 作为 beta 版本 `VolumeSnapshot` 部署过程的一部分,Kubernetes 团队提供了一个部署于控制平面的快照控制器,并且提供了一个叫做 `csi-snapshotter` 的 sidecar 帮助容器,它和 CSI 驱动程序部署在一起。快照控制器监视 `VolumeSnapshot``VolumeSnapshotContent` 对象,并且负责动态的创建和删除 `VolumeSnapshotContent` 对象。sidecar csi-snapshotter 监视 `VolumeSnapshotContent` 对象,并且触发针对 CSI 端点的 `CreateSnapshot``DeleteSnapshot` 的操作。
73-
* CSI 驱动可能实现,也可能没有实现卷快照功能。CSI 驱动可能会使用 csi-snapshotter 来提供对卷快照的支持。详见 [CSI 驱动程序文档](https://kubernetes-csi.github.io/docs/)
75+
* 作为 `VolumeSnapshot` 部署过程的一部分,Kubernetes 团队提供了一个部署于控制平面的快照控制器,
76+
并且提供了一个叫做 `csi-snapshotter` 的 sidecar 帮助容器,它和 CSI 驱动程序部署在一起。
77+
快照控制器监视 `VolumeSnapshot``VolumeSnapshotContent` 对象,
78+
并且负责动态供应中的创建和删除 `VolumeSnapshotContent` 对象。
79+
sidecar csi-snapshotter 监视 `VolumeSnapshotContent` 对象,
80+
并且触发针对 CSI 端点的 `CreateSnapshot``DeleteSnapshot` 的操作。
81+
* 还有一个验证 webhook服务器,它可以对快照对象进行更严格的验证。
82+
Kubernetes 发行版应将其与快照控制器和 CRD(而非 CSI 驱动程序)一起安装。
83+
它应该安装在所有启用了快照功能的 Kubernetes 集群中。
84+
* CSI 驱动可能实现,也可能没有实现卷快照功能。CSI 驱动可能会使用 csi-snapshotter
85+
来提供对卷快照的支持。详见 [CSI 驱动程序文档](https://kubernetes-csi.github.io/docs/)
7486
* Kubernetes 负责 CRDs 和快照控制器的安装。
7587

7688
<!--
@@ -126,13 +138,14 @@ In the case of pre-provisioned binding, the VolumeSnapshot will remain unbound u
126138
<!--
127139
### Persistent Volume Claim as Snapshot Source Protection
128140
129-
The purpose of the Persistent Volume Claim Object in Use Protection feature is to ensure that in-use PVC API objects are not removed from the system (as this may result in data loss).
141+
The purpose of this protection is to ensure that in-use
142+
{{< glossary_tooltip text="PersistentVolumeClaim" term_id="persistent-volume-claim" >}}
143+
API objects are not removed from the system while a snapshot is being taken from it (as this may result in data loss).
130144
131-
The purpose of this protection is to ensure that in-use PersistentVolumeClaim API objects are not removed from the system while a snapshot is being taken from it (as this may result in data loss).
132145
-->
133146
### 快照源的持久性卷声明保护
134147

135-
这种保护的目的是确保在从系统中获取快照时,不会将正在使用的 `PersistentVolumeClaim` API 对象从系统中删除(因为这可能会导致数据丢失)。
148+
这种保护的目的是确保在从系统中获取快照时,不会将正在使用的 {{< glossary_tooltip text="PersistentVolumeClaim" term_id="persistent-volume-claim" >}} API 对象从系统中删除(因为这可能会导致数据丢失)。
136149

137150
<!--
138151
@@ -161,7 +174,7 @@ Each VolumeSnapshot contains a spec and a status.
161174
每个 `VolumeSnapshot` 包含一个 spec 和一个状态。
162175

163176
```yaml
164-
apiVersion: snapshot.storage.k8s.io/v1beta1
177+
apiVersion: snapshot.storage.k8s.io/v1
165178
kind: VolumeSnapshot
166179
metadata:
167180
name: new-snapshot-test
@@ -191,7 +204,7 @@ For pre-provisioned snapshots, you need to specify a `volumeSnapshotContentName`
191204
对于预配置的快照 `source` 中的`volumeSnapshotContentName` 字段是必填的。
192205

193206
```yaml
194-
apiVersion: snapshot.storage.k8s.io/v1beta1
207+
apiVersion: snapshot.storage.k8s.io/v1
195208
kind: VolumeSnapshot
196209
metadata:
197210
name: test-snapshot
@@ -209,7 +222,7 @@ Each VolumeSnapshotContent contains a spec and status. In dynamic provisioning,
209222
每个 VolumeSnapshotContent 对象包含 spec 和 status。在动态配置时,快照通用控制器创建 `VolumeSnapshotContent` 对象。下面是例子:
210223

211224
```yaml
212-
apiVersion: snapshot.storage.k8s.io/v1beta1
225+
apiVersion: snapshot.storage.k8s.io/v1
213226
kind: VolumeSnapshotContent
214227
metadata:
215228
name: snapcontent-72d9a349-aacd-42d2-a240-d775650d2455
@@ -235,7 +248,7 @@ For pre-provisioned snapshots, you (as cluster administrator) are responsible fo
235248
对于预配置快照,你(作为集群管理员)要按如下命令来创建 `VolumeSnapshotContent` 对象。
236249

237250
```yaml
238-
apiVersion: snapshot.storage.k8s.io/v1beta1
251+
apiVersion: snapshot.storage.k8s.io/v1
239252
kind: VolumeSnapshotContent
240253
metadata:
241254
name: new-snapshot-content-test
@@ -270,4 +283,3 @@ For more details, see
270283
-->
271284
更多详细信息,请参阅
272285
[卷快照和从快照还原卷](/zh/docs/concepts/storage/persistent-volumes/#volume-snapshot-and-restore-volume-from-snapshot-support)。
273-

0 commit comments

Comments
 (0)