
# volumes
可选项，用于定义各个任务挂载哪些共享存储，以及挂载的路径。任务可以挂载多块共享存储。
#### volumes格式
```
volumes: 
  <共享卷名称>:
    mount_path: <挂载到容器中的路径>
    mount_from: <共享存储的详细信息>
```
表1参数属性说明 
| 属性         | 是否必选 | 参数类型            | 取值约束                                                                                                                     |
|:---|:---|:---|:---|
| mount_path | 是    | String          | 将共享存储挂载到容器中的路径，可填写任意路径，如果指定路径已存在则会覆盖。 说明： 请确保此路径为合法路径。 |
| mount_from | 是    | Struct          | 共享存储的详细信息，参数描述请参见[表2]。                                                               |
| only_to    | 否    | array\[string\] | 指定需要挂载卷的步骤，为空则默认所有步骤均需要挂该卷。                                                                                              |
   
 表2mount_from属性说明 
| 属性       | 是否必选 | 参数类型 | 取值约束                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| pvc      | 是    | 字符串  | CCE集群、CCI中共享存储（PVC）名字。可以在CCE、CCI界面上查询需要的PVC名称，GCS支持云硬盘卷、文件存储卷、对象存储卷和极速文件存储卷，具体请参见[图1]和[图2]。 说明： 指定的PVC必须存在。 基因容器服务提供了3个内置的共享存储可供挂载，分别为： - ${GCS_REF_PVC}，基因容器提供的参考组OBS桶。  - ${GCS_DATA_PVC} ，关联OBS桶，表示基因容器环境关联的OBS桶。  - ${GCS_SFS_PVC}，加速SFS卷，表示基因容器环境关联的SFS卷。   |
| sub_path | 否    | 字符串  | 只挂载共享存储的某个子目录。如：abc 或者 abc/def 可以使用 [inputs变量](https://support.huaweicloud.com/tr-gcs/gcs_tr_01_0004.html) 注意：挂载子目录abc，则写abc可以，不要写 /abc                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
图1查询CCE PVC名称   
![](https://support.huaweicloud.com/tr-gcs/zh-cn_image_0260852637.png)
图2查询CCI PVC名称   
![](https://support.huaweicloud.com/tr-gcs/zh-cn_image_0260855785.png)
#### volumes配置样例
以下示例，使得每个任务容器会挂载5个共享存储，也就是所有的容器可以看到一样的共享目录。
```
volumes:
  genref:
    mount_path: '${volume-path-ref}'
    mount_from:
      pvc: '${GCS_REF_PVC}' #内置变量，基因容器提供的参考组OBS桶
  genobs:
    mount_path: '${volume-path-obs}'
    mount_from:
      pvc: '${GCS_DATA_PVC}' #内置变量，环境关联的OBS桶
  gensfs:
    mount_path: '${volume-path-sfs}'
    mount_from:
      pvc: '${GCS_SFS_PVC}' #内置变量，加速存储盘
  other:
    mount_path: /home/mydata
    mount_from:
      pvc: '${my_k8s_pvc}' # 关联的Kubernetes集群中的任意共享存储（PVC）名字
  subdir:
    mount_path: /home/subdir
    mount_from:
      pvc: '${my_k8s_pvc}'
      sub_path: '${path_var}'  #仅挂载共享存储的某个子目录，可以使用inputs变量，如: path_var = abc/def
```
