摘要：為了與規(guī)范的更改保持一致，對象中的字段已重命名為。在最初的版本中，快照不支持指定回收政策的功能。卷快照的可以是刪除或保留。年中國論壇提案征集現(xiàn)已開放論壇讓用戶開發(fā)人員從業(yè)人員匯聚一堂，面對面進(jìn)行交流合作。

作者：Jing Xu（谷歌）、Xing Yang（華為）、Saad Ali（谷歌）

Kubernetes v1.12引入了卷快照（volume snapshot）支持作為alpha功能。在Kubernetes v1.13，它仍然是alpha功能，但增加了一些強(qiáng)化和一些重大更改。這篇文章總結(jié)了這些變化。

CSI spec v1.0對卷快照功能進(jìn)行了一些重大更改。CSI驅(qū)動程序維護(hù)者在升級其驅(qū)動程序以支持v1.0時，應(yīng)該了解這些更改。

在CSI v0.3.0，CreateSnapshotResponse中定義了SnapshotStatus枚舉（enum），表示快照是READY，UPLOADING，還是ERROR_UPLOADING。在CSI v1.0，SnapshotStatus已從CreateSnapshotResponse中刪除，并替換為布爾值（boolean）ReadyToUse。ReadyToUse值為true，表示完成后快照處理（post snapshot processing），例如上載，并且快照已準(zhǔn)備好用作創(chuàng)建卷的源。

需要進(jìn)行后快照處理的存儲系統(tǒng)（例如在快照完成后上傳），應(yīng)該在快照完成后返回成功的CreateSnapshotResponse，并將ReadyToUse字段設(shè)置為false。這表示容器箱編排系統(tǒng)（Container Orchestration System，CO），可以恢復(fù)因?yàn)檫M(jìn)行快照而停頓的任何工作負(fù)載。然后，CO可以重復(fù)調(diào)用CreateSnapshot，直到ReadyToUse字段設(shè)置為true，或該調(diào)用返回一個錯誤，指示處理中出現(xiàn)問題。CSI ListSnapshot調(diào)用可以與snapshot_id過濾一起使用，以確定快照是否可以使用，但不推薦使用這個方式，因?yàn)樗鼰o法在處理過程中檢測錯誤（ReadyToUse字段只是無限期地保持為false）。

CSI外部快照邊車容器（external-snapshotter sidecar container）的v1.x.x版本，已通過調(diào)用CreateSnapshot，而不是ListSnapshots來處理此更改，以檢查快照是否可以使用。當(dāng)升級驅(qū)動程序到CSI 1.0時，驅(qū)動程序維護(hù)者應(yīng)使用相應(yīng)的1.0兼容邊車（sidecar）容器。

為了與CSI規(guī)范的更改保持一致，VolumeSnapshot API對象中的Ready字段已重命名為ReadyToUse。當(dāng)執(zhí)行kubectl describe volumesnapshot以查看快照的詳細(xì)信息時，用戶可以看到此更改。

快照的創(chuàng)建時間作為VolumeSnapshotContent API對象的一部分可供Kubernetes管理員使用。該字段使用CSI CreateSnapshotResponse中的creation_time字段填充。在CSI v1.0中，此creation_time字段類型已更改為.google.protobuf.Timestamp，而不是int64。將驅(qū)動程序升級到CSI 1.0時，驅(qū)動程序維護(hù)者必須相應(yīng)地進(jìn)行更改。CSI外部快照程序邊車容器的v1.x.x版本已更新以處理此更改。

以下VolumeSnapshotClass參數(shù)已被棄用（deprecated），將在以后的版本中刪除。它們將替換為下面Replacement“替換”部分中列出的參數(shù)。

棄用csiSnapshotterSecretName，替換csi.storage.k8s.io/snapshotter-secret-name

棄用csiSnapshotterSecretNameSpace，替換csi.storage.k8s.io/snapshotter-secret-namespace

如在宣布快照alpha的初始博客文章中所述，Kubernetes快照API類似于PV/PVC API：就像卷（volume），由綁定的PVC和PV對表示一樣，快照由綁定的VolumeSnapshot和VolumeSnapshotContent對表示。

對于PV/PVC對，當(dāng)用戶完成使用卷時，他們可以刪除PVC。PV上的回收政策決定PV之后的處理（是刪除，還是保留）。

在最初的alpha版本中，快照不支持指定回收政策的功能。當(dāng)刪除快照對象時，它總是導(dǎo)致快照被刪除。在Kubernetes v1.13中，添加了快照內(nèi)容DeletionPolicy。它使管理員，能夠配置VolumeSnapshotContent在綁定的VolumeSnapshot對象被刪除后的處理方式。卷快照的DeletionPolicy可以是Retain（刪除）或Delete（保留）。如果未指定該值，則缺省值取決于SnapshotContent對象，是通過靜態(tài)綁定，還是動態(tài)配置創(chuàng)建的。

Retain（保留）政策允許手動回收資源。如果是靜態(tài)創(chuàng)建并綁定VolumeSnapshotContent，則默認(rèn)的DeletionPolicy為Retain。刪除VolumeSnapshot時，VolumeSnapshotContent繼續(xù)存在，VolumeSnapshotContent被視為“已釋放”（“released”）。但它不能用于綁定到其他VolumeSnapshot對象，因?yàn)樗瑪?shù)據(jù)。由管理員決定如何處理剩余的API對象和資源清理。

Delete（刪除）政策允許從Kubernetes自動刪除綁定的VolumeSnapshotContent對象，以及外部基礎(chǔ)結(jié)構(gòu)中的關(guān)聯(lián)存儲資產(chǎn)（例如AWS EBS快照，或GCE PD快照等）。動態(tài)配置的快照會繼承其VolumeSnapshotClass的刪除政策，該政策默認(rèn)為Delete。

管理員應(yīng)使用所需的保留政策配置VolumeSnapshotClass。創(chuàng)建政策后，通過修補(bǔ)（patching）對象，可以更改單個VolumeSnapshotContent的政策。

以下示例演示如何檢查動態(tài)調(diào)配的VolumeSnapshotContent的刪除政策。

$ kubectl create -f ./examples/kubernetes/demo-defaultsnapshotclass.yaml
$ kubectl create -f ./examples/kubernetes/demo-snapshot.yaml
$ kubectl get volumesnapshots demo-snapshot-podpvc -o yaml
apiVersion: snapshot.storage.k8s.io/v1alpha1
kind: VolumeSnapshot
metadata:
  creationTimestamp: "2018-11-27T23:57:09Z"
...
spec:
  snapshotClassName: default-snapshot-class
  snapshotContentName: snapcontent-26cd0db3-f2a0-11e8-8be6-42010a800002
  source:
    apiGroup: null
    kind: PersistentVolumeClaim
    name: podpvc
status:
…
$ kubectl get volumesnapshotcontent snapcontent-26cd0db3-f2a0-11e8-8be6-42010a800002 -o yaml
apiVersion: snapshot.storage.k8s.io/v1alpha1
kind: VolumeSnapshotContent
…
spec:
  csiVolumeSnapshotSource:
    creationTime: 1546469777852000000
    driver: pd.csi.storage.gke.io
    restoreSize: 6442450944
    snapshotHandle: projects/jing-k8s-dev/global/snapshots/snapshot-26cd0db3-f2a0-11e8-8be6-42010a800002
  deletionPolicy: Delete
  persistentVolumeRef:
    apiVersion: v1
    kind: PersistentVolume
    name: pvc-853622a4-f28b-11e8-8be6-42010a800002
    resourceVersion: "21117"
    uid: ae400e9f-f28b-11e8-8be6-42010a800002
  snapshotClassName: default-snapshot-class
  volumeSnapshotRef:
    apiVersion: snapshot.storage.k8s.io/v1alpha1
    kind: VolumeSnapshot
    name: demo-snapshot-podpvc
    namespace: default
    resourceVersion: "6948065"
    uid: 26cd0db3-f2a0-11e8-8be6-42010a800002

用戶可以使用補(bǔ)丁（patch）更改刪除政策：

$ kubectl patch volumesnapshotcontent snapcontent-26cd0db3-f2a0-11e8-8be6-42010a800002 -p "{"spec":{"deletionPolicy":"Retain"}}" --type=merge

$ kubectl get volumesnapshotcontent snapcontent-26cd0db3-f2a0-11e8-8be6-42010a800002 -o yaml
apiVersion: snapshot.storage.k8s.io/v1alpha1
kind: VolumeSnapshotContent
...
spec:
  csiVolumeSnapshotSource:
...
  deletionPolicy: Retain
  persistentVolumeRef:
    apiVersion: v1
    kind: PersistentVolume
    name: pvc-853622a4-f28b-11e8-8be6-42010a800002
...

“保護(hù)使用中的快照對象”（Snapshot Object in Use Protection）功能的目的，是確保不會從系統(tǒng)中刪除正在使用的快照API對象（因?yàn)檫@可能會導(dǎo)致數(shù)據(jù)丟失）。有兩種情況需要“使用中”（“in-use”）保護(hù)：

如果卷快照正在被PVC作為創(chuàng)建卷的源。

如果VolumeSnapshotContent API對象綁定到VolumeSnapshot API對象，會認(rèn)為該內(nèi)容對象正在使用中。

如果用戶刪除PVC正在使用的VolumeSnapshot API對象，VolumeSnapshot對象不會被立即刪除。刪除VolumeSnapshot對象被推遲，直到任何PVC不再使用VolumeSnapshot。同樣，如果管理員刪除了綁定到VolumeSnapshot的VolumeSnapshotContent，VolumeSnapshotContent不會被立即刪除。刪除VolumeSnapshotContent被推遲，直到VolumeSnapshotContent沒有綁定到VolumeSnapshot對象。

快照僅在CSI驅(qū)動程序支持（不適用于樹內(nèi)“in-tree”或Flexvolume）。要使用Kubernetes快照功能，請確保在群集上部署實(shí)現(xiàn)快照的CSI驅(qū)動程序。

截至本博文發(fā)布時，以下CSI驅(qū)動程序支持快照：

GCE Persistent Disk CSI Driver

OpenSDS CSI Driver

Ceph RBD CSI Driver

Portworx CSI Driver

GlusterFS CSI Driver

Digital Ocean CSI Driver

Ember CSI Driver

Cinder CSI Driver

Datera CSI Driver

NexentaStor CSI Driver

其他驅(qū)動程序的快照支持正在等待階段，應(yīng)該很快就可以使用。閱讀“Kubernetes的容器存儲接口（CSI）GA了”博客文章，了解有關(guān)CSI以及如何部署CSI驅(qū)動程序的更多信息。

根據(jù)反饋和采用情況，Kubernetes團(tuán)隊計劃將CSI Snapshot實(shí)施在1.15或1.16版本推向beta。我們感興趣的一些功能包括一致性組（consistency group）、應(yīng)用程序一致性快照、工作負(fù)載停頓、就地恢復(fù)等。

快照API和控制器的代碼存儲庫位于：https://github.com/kubernetes...

在此處查看有關(guān)快照功能的其他文檔：http://k8s.io/docs/concepts/s...://kubernetes-csi.github.io/docs/

像所有Kubernetes一樣，這個項目是許多來自不同背景的貢獻(xiàn)者共同努力的結(jié)果。

特別感謝所有幫助增加CSI v1.0支持，并改進(jìn)此版本快照功能的貢獻(xiàn)者，包括Saad Ali（saadali）、Michelle Au（msau42）、Deep Debroy（ddebroy）、James DeFelice（jdef）、John Griffith （j-griffith）、Julian Hjortshoj（julian-hj）、Tim Hockin（thockin）、Patrick Ohly（pohly）、Luis Pabon（lpabon）、Cheng Xing（verult）、Jing Xu（jingxu97）、Shiwei Xu（wackxu）、Xing Yang（xing-yang）、Jie Yu（jieyu）、David Zhu（davidz627）。

有興趣參與CSI或Kubernetes存儲系統(tǒng)任何部分的設(shè)計和開發(fā)的人士，請加入Kubernetes存儲特別興趣小組（SIG）。我們正在快速成長，一直歡迎新的貢獻(xiàn)者。

我們還定期召開SIG-Storage Snapshot工作組會議。歡迎新的參與者加入設(shè)計和開發(fā)的討論。

2019年KubeCon + CloudNativeCon中國論壇提案征集（CFP）現(xiàn)已開放

KubeCon + CloudNativeCon 論壇讓用戶、開發(fā)人員、從業(yè)人員匯聚一堂，面對面進(jìn)行交流合作。與會人員有 Kubernetes、Prometheus 及其他云原生計算基金會 (CNCF) 主辦項目的領(lǐng)導(dǎo)，和我們一同探討云原生生態(tài)系統(tǒng)發(fā)展方向。

2019年中國開源峰會提案征集（CFP）現(xiàn)已開放

在中國開源峰會上，與會者將共同合作及共享信息，了解最新和最有趣的開源技術(shù)，包括 Linux、容器、云技術(shù)、網(wǎng)絡(luò)、微服務(wù)等；并獲得如何在開源社區(qū)中導(dǎo)向和引領(lǐng)的信息。

大會日期：

提案征集截止日期：太平洋標(biāo)準(zhǔn)時間 2 月 15 日，星期五，晚上 11:59

提案征集通知日期：2019 年 4 月 1 日

會議日程通告日期：2019 年 4 月 3 日

幻燈片提交截止日期：6 月 17 日，星期一

會議活動舉辦日期：2019 年 6 月 24 至 26 日

2019年KubeCon + CloudNativeCon + Open Source Summit China贊助方案出爐啦