在ACK中通过ossfs 2.0挂载静态OSS存储卷

RRSA方式

AccessKey方式

RRSA方式

1. 创建ossfs2-pv.yaml。

   以下PV将名为cnfs-oss-test 的 OSS Bucket挂载为一个 20GB 的只读文件系统，供集群内的 Pod 使用。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # PV名称
     name: pv-ossfs2  
   spec:
     capacity:
       # 定义存储卷容量 (此值仅用于匹配PVC)
       storage: 20Gi  
     # 访问模式
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       # 使用ossfs 2.0客户端时固定为此值
       driver: ossplugin.csi.alibabacloud.com
       # 与PV名称（metadata.name）保持一致
       volumeHandle: pv-ossfs2  
       volumeAttributes:
         fuseType: ossfs2
         # OSS Bucket名称
         bucket: oss-test 
         # 挂载Bucket的根目录或指定子目录
         path: / 
         # OSS Bucket所在地域的Endpoint
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o close_to_open=false"
         authType: "rrsa"
         # 此前创建或修改的RAM角色
         roleName: "demo-role-for-rrsa"  

   主要参数说明如下：

   参数	是否必选	说明
   fuseType	必选	使用ossfs 2.0客户端时，固定为ossfs2。
   bucket	必选	待挂载的OSS Bucket。
   path	可选	待挂载的OSS Bucket的子目录。不填写时默认挂载Bucket根目录。
   url	必选	待挂载OSS的访问域名（Endpoint）。 挂载节点和Bucket处于相同地域，或已打通VPC网络时，使用内网地址。 挂载节点和Bucket不同地域时，使用外网地址。 不同访问端口的常见填写格式如下： 内网格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 内网访问端口格式vpc100-oss-{{regionName}}.aliyuncs.com已废弃，请及时切换。 外网格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。
   otherOpts	可选	为OSS存储卷输入定制化参数，格式为-o *** -o ***，例如-o close_to_open=false。 close_to_open：默认为关闭。开启后，每次打开文件时，系统会主动向OSS发送GetObjectMeta请求，以获取文件在OSS中的最新元数据信息，从而确保元数据的实时性。但在需要大量读取小文件的场景下，频繁的元数据查询会显著增加访问延迟。 更多可选参数，请参见ossfs 2.0挂载选项说明。
   authType	必选	配置为rrsa，使用RRSA方式鉴权。
   roleName	必选	配置为此前创建或修改的RAM角色名称。 如需为不同PV配置不同权限，可创建不同的RAM角色，并在PV中配置不同的roleName。
   sigVersion	可选	请求OSS服务端的请求签名版本。 "v1"（默认）：使用OSS签名版本1。 "v4"：使用OSS签名版本4（推荐）。

   若默认的RRSA鉴权不满足需求（如使用非默认ServiceAccount或第三方OIDC），可通过修改PV配置来指定具体的ARN或ServiceAccount，详见如何在RRSA鉴权方式中使用指定的ARNs或ServiceAccount？。

2. 创建PV。

   kubectl create -f ossfs2-pv.yaml

3. 确认PV状态。

   kubectl get pv pv-ossfs2

   预期输出如下，确认PV的状态为Available。

   NAME        CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   pv-ossfs2   20Gi       ROX            Retain           Available                          <unset>                          15s

AccessKey方式

1. 将步骤一获取的AccessKey存储为Secret，供PV使用。

   将 <yourAccessKeyID>和<yourAccessKeySecret> 替换为真实凭证。Secret的Namespace需要和应用Namespace一致。

   kubectl create -n default secret generic oss-secret --from-literal='akId=<yourAccessKeyID>' --from-literal='akSecret=<yourAccessKeySecret>'

2. 创建ossfs2-pv.yaml。

   以下PV将名为cnfs-oss-test 的 OSS Bucket挂载为一个 20GiB 的只读文件系统。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # PV名称
     name: pv-ossfs2  
   spec:
     capacity:
       # 定义存储卷容量 (此值仅用于匹配PVC)
       storage: 20Gi  
     # 访问模式
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # 与PV名称（metadata.name）保持一致
       volumeHandle: pv-ossfs2   
       # 使用此前创建的Secret
       nodePublishSecretRef:
         # 存储AK信息的Secret名称
         name: oss-secret  
         # 该Secret所在的命名空间
         namespace: default  
       volumeAttributes:
         fuseType: ossfs2
         # 替换为实际Bucket名称
         bucket: cnfs-oss-test  
         # 待挂载的子目录，留空则挂载根目录
         path: /
         # OSS Bucket所在地域的Endpoint
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o close_to_open=false"

   • nodePublishSecretRef参数说明：

     参数	是否必选	说明
     name	必选	存储AccessKey信息的Secret名称。
     namespace	必选	存储AccessKey信息的Secret所在的命名空间。

   • volumeAttributes参数说明：

     参数	是否必选	说明
     fuseType	必选	使用ossfs 2.0客户端时，固定为ossfs2。
     bucket	必选	待挂载的OSS Bucket。
     path	可选	待挂载的OSS Bucket的子目录。不填写时默认挂载Bucket根目录。
     url	必选	待挂载OSS的访问域名（Endpoint）。 挂载节点和Bucket处于相同地域，或已打通VPC网络时，使用内网地址。 挂载节点和Bucket不同地域时，使用外网地址。 不同访问端口的常见填写格式如下： 内网格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 内网访问端口格式vpc100-oss-{{regionName}}.aliyuncs.com已废弃，请及时切换。 外网格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。
     otherOpts	可选	为OSS存储卷输入定制化参数，格式为-o *** -o ***，例如-o close_to_open=false。 close_to_open：默认为关闭。开启后，每次打开文件时，系统会主动向OSS发送GetObjectMeta请求，以获取文件在OSS中的最新元数据信息，从而确保元数据的实时性。但在需要大量读取小文件的场景下，频繁的元数据查询会显著增加访问延迟。 更多可选参数，请参见ossfs 2.0挂载选项说明。

3. 创建PV。

   kubectl create -f ossfs2-pv.yaml

4. 确认PV状态。

   kubectl get pv pv-ossfs2

   预期输出如下，确认PV的状态为Available。

   NAME        CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   pv-ossfs2   20Gi       ROX            Retain           Available                          <unset>                          15s