root@k8s-master-01:/data/k8s# kubectl explain  Deployment.spec.template.spec.volumes
KIND:     Deployment
VERSION:  apps/v1
RESOURCE: volumes <[]Object>
DESCRIPTION:

List of volumes that can be mounted by containers belonging to the pod.

More info: https://kubernetes.io/docs/concepts/storage/volumes
 Volume represents a named volume in a pod that may be accessed by any
 container in the pod.

FIELDS:

awsElasticBlockStore	<Object>

AWSElasticBlockStore represents an AWS Disk resource that is attached to a

kubelet's host machine and then exposed to the pod. More info:

https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
azureDisk	<Object>

AzureDisk represents an Azure Data Disk mount on the host and bind mount to

the pod.
azureFile	<Object>

AzureFile represents an Azure File Service mount on the host and bind mount

to the pod.
cephfs	<Object>

CephFS represents a Ceph FS mount on the host that shares a pod's lifetime
cinder	<Object>

Cinder represents a cinder volume attached and mounted on kubelets host

machine. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
configMap	<Object>

ConfigMap represents a configMap that should populate this volume
csi	<Object>

CSI (Container Storage Interface) represents ephemeral storage that is

handled by certain external CSI drivers (Beta feature).
downwardAPI	<Object>

DownwardAPI represents downward API about the pod that should populate this

volume
emptyDir	<Object>

EmptyDir represents a temporary directory that shares a pod's lifetime.

More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
ephemeral	<Object>

Ephemeral represents a volume that is handled by a cluster storage driver.

The volume's lifecycle is tied to the pod that defines it - it will be

created before the pod starts, and deleted when the pod is removed.
 Use this if: a) the volume is only needed while the pod runs, b) features
 of normal volumes like restoring from snapshot or capacity tracking are
 needed, c) the storage driver is specified through a storage class, and d)
 the storage driver supports dynamic volume provisioning through a
 PersistentVolumeClaim (see EphemeralVolumeSource for more information on
 the connection between this volume type and PersistentVolumeClaim).

 Use PersistentVolumeClaim or one of the vendor-specific APIs for volumes
 that persist for longer than the lifecycle of an individual pod.

 Use CSI for light-weight local ephemeral volumes if the CSI driver is meant
 to be used that way - see the documentation of the driver for more
 information.

 A pod can use both types of ephemeral volumes and persistent volumes at the
 same time.

 This is a beta feature and only available when the GenericEphemeralVolume
 feature gate is enabled.

fc	<Object>

FC represents a Fibre Channel resource that is attached to a kubelet's host

machine and then exposed to the pod.
flexVolume	<Object>

FlexVolume represents a generic volume resource that is

provisioned/attached using an exec based plugin.
flocker	<Object>

Flocker represents a Flocker volume attached to a kubelet's host machine.

This depends on the Flocker control service being running
gcePersistentDisk	<Object>

GCEPersistentDisk represents a GCE Disk resource that is attached to a

kubelet's host machine and then exposed to the pod. More info:

https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
gitRepo	<Object>

GitRepo represents a git repository at a particular revision. DEPRECATED:

GitRepo is deprecated. To provision a container with a git repo, mount an

EmptyDir into an InitContainer that clones the repo using git, then mount

the EmptyDir into the Pod's container.
glusterfs	<Object>

Glusterfs represents a Glusterfs mount on the host that shares a pod's

lifetime. More info: https://examples.k8s.io/volumes/glusterfs/README.md
hostPath	<Object>

HostPath represents a pre-existing file or directory on the host machine

that is directly exposed to the container. This is generally used for

system agents or other privileged things that are allowed to see the host

machine. Most containers will NOT need this. More info:

https://kubernetes.io/docs/concepts/storage/volumes#hostpath
iscsi	<Object>

ISCSI represents an ISCSI Disk resource that is attached to a kubelet's

host machine and then exposed to the pod. More info:

https://examples.k8s.io/volumes/iscsi/README.md
name	<string> -required-

Volume's name. Must be a DNS_LABEL and unique within the pod. More info:

https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
nfs	<Object>

NFS represents an NFS mount on the host that shares a pod's lifetime More

info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
persistentVolumeClaim	<Object>

PersistentVolumeClaimVolumeSource represents a reference to a

PersistentVolumeClaim in the same namespace. More info:

https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
photonPersistentDisk	<Object>

PhotonPersistentDisk represents a PhotonController persistent disk attached

and mounted on kubelets host machine
portworxVolume	<Object>

PortworxVolume represents a portworx volume attached and mounted on

kubelets host machine
projected	<Object>

Items for all in one resources secrets, configmaps, and downward API
quobyte	<Object>

Quobyte represents a Quobyte mount on the host that shares a pod's lifetime
rbd	<Object>

RBD represents a Rados Block Device mount on the host that shares a pod's

lifetime. More info: https://examples.k8s.io/volumes/rbd/README.md
scaleIO	<Object>

ScaleIO represents a ScaleIO persistent volume attached and mounted on

Kubernetes nodes.
secret	<Object>

Secret represents a secret that should populate this volume. More info:

https://kubernetes.io/docs/concepts/storage/volumes#secret
storageos	<Object>

StorageOS represents a StorageOS volume attached and mounted on Kubernetes

nodes.
vsphereVolume	<Object>

VsphereVolume represents a vSphere volume attached and mounted on kubelets

host machine

kubectl explain  Deployment.spec.template.spec.volumes.emptyDir
KIND:     Deployment
VERSION:  apps/v1
RESOURCE: emptyDir <Object>
DESCRIPTION:

EmptyDir represents a temporary directory that shares a pod's lifetime.

More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
 Represents an empty directory for a pod. Empty directory volumes support
 ownership management and SELinux relabeling.

FIELDS:

medium	<string>  #此目录所在的存储介质的类型，可用值为defalut或Memory，默认为defalut，表示使用节点的默认存储介质；Memory表示使用基于RAM临时文件系统tmpfs，总体可用空间受限于内存，但性能非常好，通常用于容器中的应用提供缓存存储。

What type of storage medium should back this directory. The default is ""

which means to use the node's default medium. Must be an empty string

(default) or Memory. More info:

https://kubernetes.io/docs/concepts/storage/volumes#emptydir
sizeLimit	<string> # 当前存储卷的空间限额，默认值为nil 表示不限制；不过在medium字段值为Memory时，建议务必定义此限额。

Total amount of local storage required for this EmptyDir volume. The size

limit is also applicable for memory medium. The maximum usage on memory

medium EmptyDir would be the minimum value between the SizeLimit specified

here and the sum of memory limits of all containers in a pod. The default

is nil which means that the limit is undefined. More info:

http://kubernetes.io/docs/user-guide/volumes#emptydir

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels: 
      app: ng-deploy-80
  template:
    metadata:
      labels:
        app: ng-deploy-80
    spec:
      containers:
      - name: ng-deploy-80
        image: nginx 
        ports:
        - containerPort: 80
        volumeMounts:
        - mountPath: /cache
          name: cache-volume
      volumes:
      - name: cache-volume
        emptyDir: 
          medium: Memory
          sizeLimt: 16Mi

kubectl explain  Deployment.spec.template.spec.volumes.gitRepo
KIND:     Deployment
VERSION:  apps/v1
RESOURCE: gitRepo <Object>
DESCRIPTION:

GitRepo represents a git repository at a particular revision. DEPRECATED:

GitRepo is deprecated. To provision a container with a git repo, mount an

EmptyDir into an InitContainer that clones the repo using git, then mount

the EmptyDir into the Pod's container.
 Represents a volume that is populated with the contents of a git
 repository. Git repo volumes do not support ownership management. Git repo
 volumes support SELinux relabeling.

 DEPRECATED: GitRepo is deprecated. To provision a container with a git
 repo, mount an EmptyDir into an InitContainer that clones the repo using
 git, then mount the EmptyDir into the Pod's container.

FIELDS:

directory	<string> #目标目标名称，但名称中不能包含“..”字段；"."表示将仓库中的数据直接克隆值存储卷映射的目录中，其它字符则表示将数据克隆至存储卷上以用户指定的字符串为名称的子目录中。

Target directory name. Must not contain or start with '..'. If '.' is

supplied, the volume directory will be the git repository. Otherwise, if

specified, the volume will contain the git repository in the subdirectory

with the given name.
repository	<string> -required-   #git仓库的URL，必选字段

Repository URL
revision	<string>   #特定revision提交的哈希码

Commit hash for the specified revision.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels: 
      app: ng-deploy-80
  template:
    metadata:
      labels:
        app: ng-deploy-80
    spec:
      containers:
      - name: ng-deploy-80
        image: nginx 
        ports:
        - containerPort: 80
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: html
      volumes:
      - name: cache-volume
        gitRepo:
      	  repository: https://github.com/kubernetes/kubernetes.git
          directory: .
          revision: "master"

kubectl explain  Deployment.spec.template.spec.volumes.hostPath
KIND:     Deployment
VERSION:  apps/v1
RESOURCE: hostPath <Object>
DESCRIPTION:

HostPath represents a pre-existing file or directory on the host machine

that is directly exposed to the container. This is generally used for

system agents or other privileged things that are allowed to see the host

machine. Most containers will NOT need this. More info:

https://kubernetes.io/docs/concepts/storage/volumes#hostpath
 Represents a host path mapped into a pod. Host path volumes do not support
 ownership management or SELinux relabeling.

FIELDS:

path	<string> -required- #用于指定工作节点上的目录路径，必选

Path of the directory on the host. If the path is a symlink, it will follow

the link to the real path. More info:

https://kubernetes.io/docs/concepts/storage/volumes#hostpath
type	<string>  #指定节点之上的存储类型

Type for HostPath Volume Defaults to "" More info:

https://kubernetes.io/docs/concepts/storage/volumes#hostpath

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: ng-deploy-80
  template:
    metadata:
      labels:
        app: ng-deploy-80
    spec:
      containers:
      - name: ng-deploy-80
        image: nginx 
        ports:
        - containerPort: 80
        volumeMounts:
        - mountPath: /data
          name: cache-volume
      volumes:
      - name: cache-volume
        hostPath:
          path: /opt/data