使用ossfs 1.0挂载静态OSS存储卷

RRSA方式

AccessKey方式

RRSA方式

1. 创建 pv-oss-rrsa.yaml。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # PV名称
     name: pv-oss   
     # PV标签
     labels:    
       alicloud-pvname: pv-oss
   spec:
     capacity:
       # 定义存储卷容量
       storage: 10Gi  
     # 访问模式
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # 与PV名称（metadata.name）一致
       volumeHandle: pv-oss  
       volumeAttributes:
         # 替换为实际Bucket名称
         bucket: "your-bucket-name"  
         # 挂载Bucket的根目录或指定子目录
         path: /  
         # Bucket所在地域的Endpoint
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
         authType: "rrsa"
         # 此前创建或修改的RAM角色
         roleName: "demo-role-for-rrsa"
         # OSS请求签名版本
         sigVersion: "v4"  

   参数	描述
   storage	定义OSS存储卷容量。此值仅用于匹配PVC。
   accessModes	配置访问模式，支持ReadOnlyMany和ReadWriteMany。 选择ReadOnlyMany时，ossfs将以只读模式挂载OSS Bucket。
   persistentVolumeReclaimPolicy	PV回收策略。当前OSS存储卷仅支持Retain，即删除PVC时，PV和OSS Bucket中的数据不会随之删除。
   driver	定义驱动类型。使用阿里云OSS CSI插件固定为ossplugin.csi.alibabacloud.com。
   volumeHandle	需与PV名称（metadata.name）保持一致。
   bucket	待挂载的OSS Bucket。
   path	CSI组件版本需为v1.14.8.32-c77e277b-aliyun及以上。 指定挂载点相对于 Bucket 根目录的路径。默认为 /，即挂载整个 Bucket。 ossfs版本小于1.91时，指定的 path 必须在 OSS Bucket 中预先存在。详见ossfs 1.91及以上版本新增功能说明
   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 umask=022 -o max_stat_cache_size=100000 -o allow_other。 展开查看说明 umask：更改ossfs读文件的权限。 例如，umask=022可将ossfs文件的权限变更为755，解决通过SDK、OSS控制台等其他方式上传的文件（默认权限为640）在挂载点内权限不足的问题。推荐在读写分离或多用户访问时配置。 max_stat_cache_size：设置元数据缓存的条目上限（例如100000），在内存中缓存文件元信息来提升 ls、stat 等操作的性能。 但该缓存无法及时感知通过OSS控制台、SDK、ossutil等方式对文件的修改，可能导致应用读取数据不一致。在对数据一致性有强要求时可将其设为0（禁用缓存），或通过stat_cache_expire参数调低缓存的失效时间，但会牺牲读取性能。 allow_other：允许除挂载用户外的其他用户访问挂载点中的文件和目录，适用于需要让非挂载用户也能访问数据的多用户共享环境。 更多可选参数，请参见挂载选项说明、ossfs 1.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 pv-oss-rrsa.yaml

AccessKey方式

kubectl

1. 创建pvc-oss.yaml。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     # PVC 名称
     name: pvc-oss
     namespace: default
   spec:
     # 配置访问模式。ReadOnlyMany表明ossfs将以只读模式挂载OSS Bucket
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # 声明存储容量，不能大于存储卷总量
         storage: 10Gi
     selector:
       matchLabels:
         # 通过PV标签精确匹配PV
         alicloud-pvname: pv-oss

2. 创建PVC。

   kubectl create -f pvc-oss.yaml

3. 确认PVC状态。

   kubectl get pvc pvc-oss

   输出中，PVC已绑定（Bound）PV。

   NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-oss   Bound    pv-oss   10Gi       ROX                           <unset>                 6s

控制台

1. 在ACK集群列表页面，单击目标集群名称，在集群详情页左侧导航栏，选择存储 > 存储声明。

2. 在存储声明页面，单击创建，选择存储声明类型为OSS，按照页面提示完成参数的配置和提交。

   关键参数如下。

   配置项	说明
   分配模式	选择已有存储卷。 若未创建存储卷，可设置分配模式为创建存储卷，配置创建存储卷参数。
   总量	所创建存储卷的容量，不超过存储卷容量。

kubectl

1. 创建oss-static.yaml。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-static
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
             # 容器内的挂载路径
             - name: pvc-oss
               mountPath: "/data"
           # 配置健康检查
           livenessProbe:
             exec:
               command:
               - ls
               - /data
             initialDelaySeconds: 30
             periodSeconds: 30
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               # 引用此前创建的PVC
               claimName: pvc-oss

2. 创建应用。

   kubectl create -f oss-static.yaml

3. 验证挂载结果。

   • 确认Pod处于Running状态。

     kubectl get pod -l app=nginx

   • 进入Pod，查看挂载点。

     kubectl exec -it <pod-name> -- ls /data

     输出中，可查看OSS挂载路径下的数据。

控制台