设置对象存储挂载参数

前提条件

CCE容器存储（Everest）版本要求1.2.8及以上版本。插件主要负责将挂载参数识别并传递给底层存储，指定参数是否有效依赖于底层存储是否支持。

约束与限制

挂载参数暂不支持安全容器。

对象存储挂载参数

CCE的存储插件everest在挂载对象存储时默认设置了表1和表2的参数，其中表1中的参数不可取消。

在PV中设置挂载参数

在PV中设置挂载参数可以通过mountOptions字段实现，如下所示，mountOptions支持挂载的字段请参见对象存储挂载参数。

1. 使用kubectl连接集群，详情请参见通过kubectl连接集群。
2. 在PV中设置挂载参数，示例如下：

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: everest-csi-provisioner
       everest.io/reclaim-policy: retain-volume-only      # 可选字段，删除PV，保留底层存储卷
     name: pv-obs       # PV的名称
   spec:
     accessModes:
     - ReadWriteMany    # 访问模式，对象存储必须为ReadWriteMany
     capacity:
       storage: 1Gi     # 对象存储容量大小
     csi:
       driver: obs.csi.everest.io        # 挂载依赖的存储驱动
       fsType: obsfs                     # 实例类型
       volumeHandle: <your_volume_id>    # 对象存储的名称
       volumeAttributes:
         storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
         everest.io/obs-volume-type: STANDARD
         everest.io/region: <your_region>                        # 对象存储的区域
         everest.io/enterprise-project-id: <your_project_id>     # 可选字段，企业项目ID，如果指定企业项目，则创建PVC时也需要指定相同的企业项目，否则PVC无法绑定PV。
       nodePublishSecretRef:            # 设置对象存储的自定义密钥
         name: <your_secret_name>       # 自定义密钥的名称
         namespace: <your_namespace>    # 自定义密钥的命名空间
     persistentVolumeReclaimPolicy: Retain    # 回收策略
     storageClassName: csi-obs               # 存储类名称
     mountOptions:                            # 挂载参数
     - umask=027

3. PV创建后，可以创建PVC关联PV，然后在工作负载的容器中挂载，具体操作步骤请参见通过静态存储卷使用已有对象存储。
4. 验证挂载参数是否生效。

   本例中将PVC挂载至使用nginx:latest镜像的工作负载，可以登录到运行挂载对象存储卷的Pod所在节点上通过进程详情观察。

   执行以下命令：

   • 对象桶：ps -ef | grep s3fs

     root     22142     1  0 Jun03 ?        00:00:00 /usr/bin/s3fs {your_obs_name} /mnt/paas/kubernetes/kubelet/pods/{pod_uid}/volumes/kubernetes.io~csi/{your_pv_name}/mount -o url=https://{endpoint}:443 -o endpoint={region} -o passwd_file=/opt/everest-host-connector/***_obstmpcred/{your_obs_name} -o nonempty -o big_writes -o sigv2 -o allow_other -o no_check_certificate -o ssl_verify_hostname=0 -o umask=027 -o max_write=131072 -o multipart_size=20

   • 并行文件系统：ps -ef | grep obsfs

     root      1355     1  0 Jun03 ?        00:03:16 /usr/bin/obsfs {your_obs_name} /mnt/paas/kubernetes/kubelet/pods/{pod_uid}/volumes/kubernetes.io~csi/{your_pv_name}/mount -o url=https://{endpoint}:443 -o endpoint={region} -o passwd_file=/opt/everest-host-connector/***_obstmpcred/{your_obs_name} -o allow_other -o nonempty -o big_writes -o use_ino -o no_check_certificate -o ssl_verify_hostname=0 -o max_background=100 -o umask=027 -o max_write=131072

在StorageClass中设置挂载参数

在StorageClass中设置挂载参数同样可以通过mountOptions字段实现，如下所示，mountOptions支持挂载的字段请参见对象存储挂载参数。

1. 使用kubectl连接集群，详情请参见通过kubectl连接集群。
2. 创建自定义的StorageClass，示例如下：

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: csi-obs-mount-option
   provisioner: everest-csi-provisioner
   parameters:
     csi.storage.k8s.io/csi-driver-name: obs.csi.everest.io
     csi.storage.k8s.io/fstype: s3fs
     everest.io/obs-volume-type: STANDARD
   reclaimPolicy: Delete
   volumeBindingMode: Immediate
   mountOptions:                            # 挂载参数
   - umask=027

3. StorageClass设置好后，就可以使用这个StorageClass创建PVC，动态创建出的PV会默认带有StorageClass中设置的挂载参数，具体操作步骤请参见通过动态存储卷使用对象存储。
4. 验证挂载参数是否生效。

   本例中将PVC挂载至使用nginx:latest镜像的工作负载，可以登录到运行挂载对象存储卷的Pod所在节点上通过进程详情观察。

   执行以下命令：

   • 对象桶：ps -ef | grep s3fs

     root     22142     1  0 Jun03 ?        00:00:00 /usr/bin/s3fs {your_obs_name} /mnt/paas/kubernetes/kubelet/pods/{pod_uid}/volumes/kubernetes.io~csi/{your_pv_name}/mount -o url=https://{endpoint}:443 -o endpoint={region} -o passwd_file=/opt/everest-host-connector/***_obstmpcred/{your_obs_name} -o nonempty -o big_writes -o sigv2 -o allow_other -o no_check_certificate -o ssl_verify_hostname=0 -o umask=027 -o max_write=131072 -o multipart_size=20

   • 并行文件系统：ps -ef | grep obsfs

     root      1355     1  0 Jun03 ?        00:03:16 /usr/bin/obsfs {your_obs_name} /mnt/paas/kubernetes/kubelet/pods/{pod_uid}/volumes/kubernetes.io~csi/{your_pv_name}/mount -o url=https://{endpoint}:443 -o endpoint={region} -o passwd_file=/opt/everest-host-connector/***_obstmpcred/{your_obs_name} -o allow_other -o nonempty -o big_writes -o use_ino -o no_check_certificate -o ssl_verify_hostname=0 -o max_background=100 -o umask=027 -o max_write=131072