新增说明及示例文件

description/Storage/PersistentVolumeClaims/description.yml

@@ -0,0 +1,33 @@
+# PersistentVolumeClaim（持久卷申领）说明，官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/persistent-volumes
+# API 版本
+apiVersion: v1
+# 资源名称
+kind: PersistentVolumeClaim
+# 资源元数据
+metadata:
+  ## 名称
+  name: 该 PersistentVolumeClaim 的名称【自定义，见名知意】
+# 内容
+spec:
+  ## 资源
+  resources:
+    requests: 
+      ### 容量
+      storage: 该 PersistentVolumeClaim 使用的空间大小【自定义，单位使用量纲，如：Ki、Mi、Gi、Ti、Pi、Ei】
+  ## 卷模式
+  volumeMode: 该 PersistentVolumeClaim 使用的卷模式【Filesystem：默认，文件系统；Block：块】
+  ## 访问模式
+  accessModes:
+    -  该 PersistentVolumeClaim 使用的访问模式【ReadWriteOnce：卷可以被一个节点以读写方式挂载；ReadOnlyMany：卷可以被多个节点以只读方式挂载；ReadWriteMany：卷可以被多个节点以读写方式挂载；ReadWriteOncePod：卷可以被单个 Pod 以读写方式挂载（整个集群中只有一个 Pod 可以读取和写入）】
+  ## Storage Class 名称
+  storageClassName: 该 PersistentVolumeClaim 使用的 StorageClass 的名称
+  ## 指定 PersistentVolume （ 配置后该 PersistentVolumeClaim 只能绑定指定的 PersistentVolume ）
+  volumeName: PersistentVolume 的名称
+  ## 选择器
+  selector:
+    ### 卷必须包含带有此值的标签
+    matchLabels:
+      name: value
+    ### 通过设定键（key）、值列表和操作符（operator） 来构造的需求
+    matchExpressions:
+      - {key: key的值, operator: operator的值【In：包含；NotIn：不包含；Exists：存在；DoesNotExist：不存在】,values: [value的值1,value的值2,...]}

description/Storage/PersistentVolumeClaims/example.yml

@@ -0,0 +1,17 @@
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: pvc-example
+spec:
+  resources:
+    requests: 
+      storage: 1Gi
+  volumeMode: Filesystem
+  accessModes:
+    -  ReadWriteMany
+  storageClassName: storage-local-example
+  selector:
+    matchLabels:
+      release: "stable"
+    matchExpressions:
+      - {key: environment, operator: In, values: [dev]}

description/Storage/PersistentVolumes/description.yml

@@ -0,0 +1,34 @@
+# PersistentVolume（持久卷）说明，官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/persistent-volumes
+# API 版本
+apiVersion: v1
+# 资源名称
+kind: PersistentVolume
+# 资源元数据
+metadata:
+  ## 名称
+  name: 该 PersistentVolume 的名称【自定义，见名知意】
+# 内容
+spec:
+  ## 资源
+  capacity:
+    ### 容量
+    storage: 该 PersistentVolume 使用的空间大小【自定义，单位使用量纲，如：Ki、Mi、Gi、Ti、Pi、Ei】
+  ## 卷模式
+  volumeMode: 该 PersistentVolume 使用的卷模式【Filesystem：默认，文件系统；Block：块】
+  ## 访问模式
+  accessModes:
+    -  该 PersistentVolume 使用的访问模式【ReadWriteOnce：卷可以被一个节点以读写方式挂载；ReadOnlyMany：卷可以被多个节点以只读方式挂载；ReadWriteMany：卷可以被多个节点以读写方式挂载；ReadWriteOncePod：卷可以被单个 Pod 以读写方式挂载（整个集群中只有一个 Pod 可以读取和写入）】
+  ## 回收策略
+  persistentVolumeReclaimPolicy: 该 PersistentVolume  使用的回收策略【Retain：保留、手动回收（当 PersistentVolumeClaim 被删除时，PersistentVolume 仍然存在，需要手动删除 PersistentVolume 及 PersistentVolume 中的数据）；Delete：删除（当 PersistentVolumeClaim 被删除时，自动删除 PersistentVolume 及 PersistentVolume 中的数据）】
+  ## StorageClass 名称
+  storageClassName: 该 PersistentVolume 使用的 StorageClass 的名称
+  ## 预留 PersistentVolume（配置该 PersistentVolume 只能被指定的 PersistentVolumeClaim 绑定）
+  claimRef: 
+    name: PersistentVolumeClaim 的名称
+    namespace: Namespace 的名称
+  ## 挂载选项
+  mount-options: 
+    挂载选项参数【 不同类型的存储类型参数不一样，具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/persistent-volumes/#mount-options 】
+  ## 节点亲和性
+  nodeAffinity:
+    节点亲和性参数【 local 存储类型需要声明，具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/persistent-volumes/#node-affinity 】

description/Storage/PersistentVolumes/example-local.yml

@@ -0,0 +1,24 @@
+apiVersion: v1
+kind: PersistentVolume
+metadata:
+  name: pv-local-example
+spec:
+  capacity:
+    storage: 5Gi
+  volumeMode: Filesystem
+  accessModes:
+    - ReadWriteOnce
+  persistentVolumeReclaimPolicy: Retain
+  storageClassName: storage-local-example
+  local:
+    path: /data/k8s/pv/local/example
+  nodeAffinity:
+    required:
+      nodeSelectorTerms:
+      - matchExpressions:
+        - key: kubernetes.io/hostname
+          operator: In
+          values:
+          - nodename-example-1
+          - nodename-example-2
+          - nodename-example-3

description/Storage/PersistentVolumes/example-nfs.yml

@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: PersistentVolume
+metadata:
+  name: pv-nfs-example
+spec:
+  capacity:
+    storage: 5Gi
+  accessModes:
+    - ReadWriteMany
+  nfs:
+    server: nfs-server.default.svc.cluster.local
+    path: "/"
+  mountOptions:
+    - nfsvers=4.2

description/Storage/StorageClass/description.yml

@@ -0,0 +1,23 @@
+# StorageClass（存储类） 说明，官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/storage-classes 
+# API 版本
+apiVersion: storage.k8s.io/v1
+# 资源名称
+kind: StorageClass
+# 资源元数据
+metadata:
+  ## 名称
+  name: 该 StorageClass 的名称【自定义，见名知意】
+# 制备器（供应商）
+provisioner: 该 StorageClass 使用的制备器【可选制备器见官方文档： https://kubernetes.io/zh-cn/docs/concepts/storage/storage-classes/#provisioner 】
+# 回收策略
+reclaimPolicy: 该 StorageClass 的回收策略【Delete：删除（默认，当使用此 PersistentVolume 的对象被删除时，此 PersistentVolume 自动删除）；Retain：保留（当使用此 PersistentVolume 的对象被删除时，此 PersistentVolume 不会自动删除）】
+# 卷捆绑模型
+volumeBindingMode: 该 StorageClass 的绑定模式【Immediate：默认，PersistentVolumeClaim 创建后立即完成制备和绑定；WaitForFirstConsumer：使用 PersistentVolumeClaim 的 Pod 被创建后才制备和绑定】
+# 允许的拓扑结构
+allowedTopologies: 该 StorageClass 允许的拓扑架构【具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/storage-classes/#allowed-topologies 】
+# 是否允许卷扩展
+allowVolumeExpansion: 是否允许卷扩展【true：允许；false：不允许。仅部分制备器可用，具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/storage-classes/#allow-volume-expansion 】
+# 挂载选项
+mountOptions: 该 StorageClass 的挂载选项【仅部分制备器可用，具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/persistent-volumes/#mount-options 】
+# 参数
+parameters: 该 StorageClass 的参数【使用不同类型的制备器时参数不一样，具体见官方文档：https://kubernetes.io/zh-cn/docs/concepts/storage/storage-classes/#parameters 】

description/Storage/StorageClass/example-local.yml

@@ -0,0 +1,7 @@
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: storage-local-example
+provisioner: kubernetes.io/no-provisioner
+reclaimPolicy: Retain
+volumeBindingMode: WaitForFirstConsumer