网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
云手机服务器 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器(旧版)
VR云渲游平台 CVR
Huawei Cloud EulerOS
云化数据中心 CloudDC
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘平台 IEF
CloudPond云服务
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
湖仓构建 LakeFormation
智能数据洞察 DataArts Insight
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
开天aPaaS
应用平台 AppStage
开天企业工作台 MSSE
开天集成工作台 MSSI
API中心 API Hub
云消息服务 KooMessage
交换数据空间 EDS
云地图服务 KooMap
云手机服务 KooPhone
组织成员账号 OrgID
云空间服务 KooDrive
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
区块链
区块链服务 BCS
数字资产链 DAC
华为云区块链引擎服务 HBS
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
价格
成本优化最佳实践
专属云商业逻辑
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
其他
管理控制台
消息中心
产品价格详情
系统权限
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
云服务信任体系能力说明
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
云存储网关 CSG
专属分布式存储服务 DSS
数据工坊 DWR
地图数据 MapDS
键值存储服务 KVS
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
云原生服务中心 OSC
应用服务网格 ASM
华为云UCS
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB
云数据库 GeminiDB
数据管理服务 DAS
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
语音交互服务 SIS
人证核身服务 IVS
视频智能分析服务 VIAS
城市智能体
自动驾驶云服务 Octopus
盘古大模型 PanguLargeModels
IoT物联网
设备接入 IoTDA
全球SIM联接 GSL
IoT数据分析 IoTA
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
企业应用
域名注册服务 Domains
云解析服务 DNS
企业门户 EWP
ICP备案
商标注册
华为云WeLink
华为云会议 Meeting
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMA Exchange
API全生命周期管理 ROMA API
政企自服务管理 ESM
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
数字内容生产线 MetaStudio
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
专属云
专属计算集群 DCC
开发者工具
SDK开发指南
API签名指南
DevStar
华为云命令行工具服务 KooCLI
Huawei Cloud Toolkit
CodeArts API
云化转型
云架构中心
云采用框架
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
我的凭证
华为云公共事业服务云平台
工业软件
工业数字模型驱动引擎
硬件开发工具链平台云服务
工业数据转换引擎云服务
文档首页/ 云容器引擎 CCE/ 用户指南/ 存储/ 文件存储(SFS)/ 通过静态存储卷使用已有文件存储

通过静态存储卷使用已有文件存储

更新时间:2025-02-18 GMT+08:00
分享

文件存储(SFS)是一种可共享访问,并提供按需扩展的高性能文件系统(NAS),适用大容量扩展以及成本敏感型的业务场景。本文介绍如何使用已有的文件存储静态创建PV和PVC,并在工作负载中实现数据持久化与共享性。

前提条件

  • 您已经创建好一个集群,并且在该集群中安装CCE容器存储(Everest)
  • 如果您需要通过命令行创建,需要使用kubectl连接到集群,详情请参见通过kubectl连接集群
  • 您已经创建好一个文件存储,并且文件存储与集群在同一个VPC内。
  • 使用通用文件系统(SFS 3.0)时,您需要提前在集群所在VPC创建一个VPC终端节点,集群需要通过VPC终端节点访问通用文件系统。配置VPC终端节点的方法请参见配置VPC终端节点

约束与限制

  • 支持多个PV挂载同一个SFS或SFS Turbo,但有如下限制:
    • 多个不同的PVC/PV使用同一个底层SFS或SFS Turbo卷时,如果挂载至同一Pod使用,会因为PV的volumeHandle参数值相同导致无法为Pod挂载所有PVC,出现Pod无法启动的问题,请避免该使用场景。
    • PV中persistentVolumeReclaimPolicy参数建议设置为Retain,否则可能存在一个PV删除时级联删除底层卷,其他关联这个底层卷的PV会由于底层存储被删除导致使用出现异常。
    • 重复用底层存储时,建议在应用层做好多读多写的隔离保护,防止产生的数据覆盖和丢失。
  • 使用通用文件系统(SFS 3.0)存储卷时,集群中需要安装2.0.9及以上版本的CCE容器存储(Everest)插件。
  • 使用通用文件系统(SFS 3.0)存储卷时,挂载点不支持修改属组和权限,挂载点默认属主为root。
  • 使用通用文件系统(SFS 3.0)时,创建、删除PVC和PV过程中可能存在时延,实际计费时长请以SFS侧创建、删除时刻为准。
  • 通用文件系统(SFS 3.0)使用Delete回收策略时,需要挂载文件系统手动删除所有文件后才可以正常删除PV和PVC。

通过控制台使用已有文件存储

  1. 登录CCE控制台,单击集群名称进入集群。
  2. 静态创建存储卷声明和存储卷。

    1. 在左侧导航栏选择“存储”,在右侧选择“存储卷声明”页签。单击右上角“创建存储卷声明 PVC”,在弹出的窗口中填写存储卷声明参数。

      参数

      描述

      存储卷声明类型

      本文中选择“文件存储”。

      PVC名称

      输入PVC的名称,同一命名空间下的PVC名称需唯一。

      创建方式

      • 已有底层存储的场景下,根据是否已经创建PV可选择“新建存储卷”“已有存储卷”来静态创建PVC。
      • 无可用底层存储的场景下,可选择“动态创建存储实例”,具体操作请参见通过动态存储卷使用文件存储

      本文示例中选择“新建存储卷”,可通过控制台同时创建PV及PVC。

      关联存储卷a

      选择集群中已有的PV卷,需要提前创建PV,请参考相关操作中的“创建存储卷”操作。

      本文示例中无需选择。

      文件存储b

      单击“选择文件存储”,您可以在新页面中勾选满足要求的文件存储,并单击“确定”

      说明:

      当前仅支持选择通用文件系统(SFS 3.0)类型的文件存储。

      子目录b

      选择是否使用子目录创建PV。请填写子目录绝对路径,例如/a/b,并确保子目录已存在且可用。

      PV名称b

      输入PV名称,同一集群内的PV名称需唯一。

      访问模式b

      文件存储类型的存储卷仅支持ReadWriteMany,表示存储卷可以被多个节点以读写方式挂载,详情请参见存储卷访问模式

      回收策略b

      您可以选择Delete或Retain,用于指定删除PVC时底层存储的回收策略,详情请参见PV回收策略

      说明:

      多个PV使用同一个底层存储时建议使用Retain,避免级联删除底层卷。

      子目录回收策略b

      删除PVC时是否保留子目录,该参数需与PV回收策略配合使用,当使用子目录创建PV,且PV回收策略为"Delete"时支持配置。

      • 保留:删除PVC,PV会被删除,但PV关联的子目录会被保留
      • 删除:删除PVC,PV及其关联的子目录均会被删除

      挂载参数b

      输入挂载参数键值对,详情请参见设置文件存储挂载参数

      说明:

      a:创建方式选择“已有存储卷”时可设置。

      b:创建方式选择“新建存储卷”时可设置。

    2. 单击“创建”,将同时为您创建存储卷声明和存储卷。

      您可以在左侧导航栏中选择“存储”,在“存储卷声明”“存储卷”页签下查看已经创建的存储卷声明和存储卷。

  3. 创建应用。

    1. 在左侧导航栏中选择“工作负载”,在右侧选择“无状态负载”页签。
    2. 单击页面右上角“创建工作负载”,在“容器配置”中选择“数据存储”页签,并单击“添加存储卷 > 已有存储卷声明 (PVC)”。
      本文主要为您介绍存储卷的挂载使用,如表1,其他参数详情请参见工作负载
      表1 存储卷挂载

      参数

      参数说明

      存储卷声明(PVC)

      选择已有的文件存储卷。

      挂载路径

      请输入挂载路径,如:/tmp。

      数据存储挂载到容器上的路径。请不要挂载在系统目录下,如“/”、“/var/run”等,会导致容器异常。建议挂载在空目录下,若目录不为空,请确保目录下无影响容器启动的文件,否则文件会被替换,导致容器启动异常,工作负载创建失败。
      须知:

      挂载高危目录的情况下 ,建议使用低权限账号启动,否则可能会造成宿主机高危文件被破坏。

      子路径

      请输入存储卷的子路径,将存储卷中的某个路径挂载至容器,可以实现在单一Pod中使用同一个存储卷的不同文件夹。如:tmp,表示容器中挂载路径下的数据会存储在存储卷的tmp文件夹中。不填写时默认为根路径。

      权限

      • 只读:只能读容器路径中的数据卷。
      • 读写:可修改容器路径中的数据卷,容器迁移时新写入的数据不会随之迁移,会造成数据丢失。

      本例中将该存储卷挂载到容器中/data路径下,在该路径下生成的容器数据会存储到文件存储中。

    3. 其余信息都配置完成后,单击“创建工作负载”

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

通过kubectl命令行使用已有文件存储

您可以根据不同的使用场景选择不同的创建方式。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # 可选字段,删除PV,保留底层存储卷
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: <sfs30_name>   # 使用通用文件系统(SFS 3.0)时填写文件存储名称
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
            everest.io/sfs-version: sfs3.0       # 使用通用文件系统(SFS 3.0)
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-sfs               # 存储类名称,csi-sfs表示使用通用文件系统(SFS 3.0)
        mountOptions: []                         # 挂载参数
      表2 关键参数说明

      参数

      是否必选

      描述

      everest.io/reclaim-policy

      目前仅支持配置“retain-volume-only”

      everest插件版本需 >= 1.2.9且回收策略为Delete时生效。如果回收策略是Delete且当前值设置为“retain-volume-only”删除PVC回收逻辑为:删除PV,保留底层存储卷。

      volumeHandle

      使用通用文件系统(SFS 3.0)时,填写文件存储的名称。

      everest.io/share-export-location

      通用文件系统(SFS 3.0)的共享路径。

      共享路径格式如下:

      {your_sfs30_name}.sfs3.{region}.myhuaweicloud.com:/{your_sfs30_name}

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称,填写csi-sfs,表示使用通用文件系统(SFS 3.0)。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-sfs     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表3 关键参数说明

      参数

      是否必选

      描述

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-sfs,必须与1中PV的存储类一致,表示使用通用文件系统(SFS 3.0)。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: pv-sfs    # 使用子目录时填写PV的名称
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
            everest.io/sfs-version: sfs3.0       # 使用通用文件系统(SFS 3.0)
            everest.io/csi.volume-as: absolute-path   # 表示使用SFS子目录
            everest.io/csi.path: /a  # 表示自动创建的子目录,必须为绝对路径
            everest.io/csi.sfs30-name: <sfs_name>     # 仅使用子目录时使用,参数值为SFS实例的名称
            everest.io/csi.reclaim-policy: retain-volume-only    # 仅使用子目录且回收策略为Delete时使用,表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-sfs               # 存储类名称:csi-sfs表示使用通用文件系统(SFS 3.0)
        mountOptions: []                         # 挂载参数
      表4 关键参数说明

      参数

      是否必选

      描述

      volumeHandle

      使用SFS子目录时,填写PV名称。

      everest.io/share-export-location

      通用文件系统(SFS 3.0)的共享路径。

      共享路径格式如下:

      {your_sfs30_name}.sfs3.{region}.myhuaweicloud.com:/{your_sfs30_name}/{absolute_path}

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      everest.io/csi.volume-as

      固定取值为“absolute-path”,表示使用动态创建SFS子目录。

      集群中需安装2.4.41及以上版本的Everest插件。

      everest.io/csi.path

      自动创建的子目录,必须为绝对路径。

      everest.io/csi.sfs30-name

      仅动态创建SFS子目录时使用,参数值为SFS实例的名称。

      everest.io/csi.reclaim-policy

      仅动态创建SFS子目录时使用,表示删除PVC时是否保留子目录,该参数需与PV回收策略配合使用。仅当PV回收策略为"Delete"时生效,取值如下:

      • retain-volume-only:表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
      • delete:表示删除PVC,PV及其关联的子目录均会被删除
        说明:

        删除子目录时,仅删除PVC参数中设置的子目录绝对路径,不会级联删除上层目录。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称,填写csi-sfs,表示使用通用文件系统(SFS 3.0)。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
          everest.io/csi.volume-as: absolute-path # 可选,表示使用SFS子目录
          everest.io/csi.path: /a  # 自动创建的子目录,必须为绝对路径
          everest.io/csi.sfs30-name: <sfs_name>     # 使用子目录时使用,参数值为SFS实例的名称
          everest.io/csi.reclaim-policy: retain-volume-only
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-sfs     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表5 关键参数说明

      参数

      是否必选

      描述

      everest.io/csi.volume-as

      固定取值为“absolute-path”,表示使用动态创建SFS子目录。

      集群中需安装2.4.41及以上版本的Everest插件。

      everest.io/csi.path

      自动创建的子目录,必须为绝对路径。

      everest.io/csi.sfs30-name

      仅动态创建SFS子目录时使用,参数值为SFS实例的名称。

      everest.io/csi.reclaim-policy

      仅动态创建SFS子目录时使用,表示删除PVC时是否保留子目录,该参数需与PV回收策略配合使用。仅当PV回收策略为"Delete"时生效,取值如下:

      • retain-volume-only:表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
      • delete:表示删除PVC,PV及其关联的子目录均会被删除
        说明:

        删除子目录时,仅删除PVC参数中设置的子目录绝对路径,不会级联删除上层目录。

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-sfs,必须与1中PV的存储类一致,表示使用通用文件系统(SFS 3.0)。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # 可选字段,删除PV,保留底层存储卷
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: <your_volume_id>   # SFS容量型文件存储的ID
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-nas               # 存储类名称,csi-nas表示使用SFS容量型
        mountOptions: []                         # 挂载参数
      表6 关键参数说明

      参数

      是否必选

      描述

      everest.io/reclaim-policy

      目前仅支持配置“retain-volume-only”

      everest插件版本需 >= 1.2.9且回收策略为Delete时生效。如果回收策略是Delete且当前值设置为“retain-volume-only”删除PVC回收逻辑为:删除PV,保留底层存储卷。

      volumeHandle

      使用SFS容量型文件存储时,填写文件存储的ID。

      获取方法:在CCE控制台,单击顶部的“服务列表 > 存储 > 弹性文件服务”,并选择SFS容量型。在列表中单击对应的弹性文件存储名称,在详情页中复制“ID”后的内容即可。

      everest.io/share-export-location

      文件存储的共享路径。

      获取方法:在CCE控制台,单击顶部的“服务列表 > 存储 > 弹性文件服务”,在弹性文件服务列表中可以看到“挂载地址”列,即为文件存储的共享路径。

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称csi-nas,表示使用SFS 1.0容量型文件存储。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-nas     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表7 关键参数说明

      参数

      是否必选

      描述

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-nas,必须与1中PV的存储类一致,表示使用SFS 1.0容量型文件存储。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # 可选字段,删除PV,保留底层存储卷
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: <sfs30_name>   # 使用通用文件系统(SFS 3.0)时填写文件存储名称
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
            everest.io/sfs-version: sfs3.0       # 使用通用文件系统(SFS 3.0)
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-sfs               # 存储类名称,csi-sfs表示使用通用文件系统(SFS 3.0)
        mountOptions: []                         # 挂载参数
      表2 关键参数说明

      参数

      是否必选

      描述

      everest.io/reclaim-policy

      目前仅支持配置“retain-volume-only”

      everest插件版本需 >= 1.2.9且回收策略为Delete时生效。如果回收策略是Delete且当前值设置为“retain-volume-only”删除PVC回收逻辑为:删除PV,保留底层存储卷。

      volumeHandle

      使用通用文件系统(SFS 3.0)时,填写文件存储的名称。

      everest.io/share-export-location

      通用文件系统(SFS 3.0)的共享路径。

      共享路径格式如下:

      {your_sfs30_name}.sfs3.{region}.myhuaweicloud.com:/{your_sfs30_name}

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称,填写csi-sfs,表示使用通用文件系统(SFS 3.0)。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-sfs     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表3 关键参数说明

      参数

      是否必选

      描述

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-sfs,必须与1中PV的存储类一致,表示使用通用文件系统(SFS 3.0)。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: pv-sfs    # 使用子目录时填写PV的名称
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
            everest.io/sfs-version: sfs3.0       # 使用通用文件系统(SFS 3.0)
            everest.io/csi.volume-as: absolute-path   # 表示使用SFS子目录
            everest.io/csi.path: /a  # 表示自动创建的子目录,必须为绝对路径
            everest.io/csi.sfs30-name: <sfs_name>     # 仅使用子目录时使用,参数值为SFS实例的名称
            everest.io/csi.reclaim-policy: retain-volume-only    # 仅使用子目录且回收策略为Delete时使用,表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-sfs               # 存储类名称:csi-sfs表示使用通用文件系统(SFS 3.0)
        mountOptions: []                         # 挂载参数
      表4 关键参数说明

      参数

      是否必选

      描述

      volumeHandle

      使用SFS子目录时,填写PV名称。

      everest.io/share-export-location

      通用文件系统(SFS 3.0)的共享路径。

      共享路径格式如下:

      {your_sfs30_name}.sfs3.{region}.myhuaweicloud.com:/{your_sfs30_name}/{absolute_path}

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      everest.io/csi.volume-as

      固定取值为“absolute-path”,表示使用动态创建SFS子目录。

      集群中需安装2.4.41及以上版本的Everest插件。

      everest.io/csi.path

      自动创建的子目录,必须为绝对路径。

      everest.io/csi.sfs30-name

      仅动态创建SFS子目录时使用,参数值为SFS实例的名称。

      everest.io/csi.reclaim-policy

      仅动态创建SFS子目录时使用,表示删除PVC时是否保留子目录,该参数需与PV回收策略配合使用。仅当PV回收策略为"Delete"时生效,取值如下:

      • retain-volume-only:表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
      • delete:表示删除PVC,PV及其关联的子目录均会被删除
        说明:

        删除子目录时,仅删除PVC参数中设置的子目录绝对路径,不会级联删除上层目录。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称,填写csi-sfs,表示使用通用文件系统(SFS 3.0)。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
          everest.io/csi.volume-as: absolute-path # 可选,表示使用SFS子目录
          everest.io/csi.path: /a  # 自动创建的子目录,必须为绝对路径
          everest.io/csi.sfs30-name: <sfs_name>     # 使用子目录时使用,参数值为SFS实例的名称
          everest.io/csi.reclaim-policy: retain-volume-only
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-sfs     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表5 关键参数说明

      参数

      是否必选

      描述

      everest.io/csi.volume-as

      固定取值为“absolute-path”,表示使用动态创建SFS子目录。

      集群中需安装2.4.41及以上版本的Everest插件。

      everest.io/csi.path

      自动创建的子目录,必须为绝对路径。

      everest.io/csi.sfs30-name

      仅动态创建SFS子目录时使用,参数值为SFS实例的名称。

      everest.io/csi.reclaim-policy

      仅动态创建SFS子目录时使用,表示删除PVC时是否保留子目录,该参数需与PV回收策略配合使用。仅当PV回收策略为"Delete"时生效,取值如下:

      • retain-volume-only:表示删除PVC时,PV会被删除,但PV关联的子目录会被保留
      • delete:表示删除PVC,PV及其关联的子目录均会被删除
        说明:

        删除子目录时,仅删除PVC参数中设置的子目录绝对路径,不会级联删除上层目录。

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-sfs,必须与1中PV的存储类一致,表示使用通用文件系统(SFS 3.0)。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

  1. 使用kubectl连接集群。
  2. 创建PV。

    1. 创建pv-sfs.yaml文件。
      示例如下:
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # 可选字段,删除PV,保留底层存储卷
        name: pv-sfs    # PV的名称
      spec:
        accessModes:
        - ReadWriteMany      # 访问模式,文件存储必须为ReadWriteMany
        capacity:
          storage: 1Gi       # 文件存储容量大小
        csi:
          driver: nas.csi.everest.io    # 挂载依赖的存储驱动
          fsType: nfs
          volumeHandle: <your_volume_id>   # SFS容量型文件存储的ID
          volumeAttributes:
            everest.io/share-export-location: <your_location>  #文件存储的共享路径
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
        persistentVolumeReclaimPolicy: Retain    # 回收策略
        storageClassName: csi-nas               # 存储类名称,csi-nas表示使用SFS容量型
        mountOptions: []                         # 挂载参数
      表6 关键参数说明

      参数

      是否必选

      描述

      everest.io/reclaim-policy

      目前仅支持配置“retain-volume-only”

      everest插件版本需 >= 1.2.9且回收策略为Delete时生效。如果回收策略是Delete且当前值设置为“retain-volume-only”删除PVC回收逻辑为:删除PV,保留底层存储卷。

      volumeHandle

      使用SFS容量型文件存储时,填写文件存储的ID。

      获取方法:在CCE控制台,单击顶部的“服务列表 > 存储 > 弹性文件服务”,并选择SFS容量型。在列表中单击对应的弹性文件存储名称,在详情页中复制“ID”后的内容即可。

      everest.io/share-export-location

      文件存储的共享路径。

      获取方法:在CCE控制台,单击顶部的“服务列表 > 存储 > 弹性文件服务”,在弹性文件服务列表中可以看到“挂载地址”列,即为文件存储的共享路径。

      mountOptions

      挂载参数。

      不设置时默认配置为如下配置,具体说明请参见设置文件存储挂载参数

      mountOptions:
      - vers=3
      - timeo=600
      - nolock
      - hard

      persistentVolumeReclaimPolicy

      集群版本号>=1.19.10且everest插件版本>=1.2.9时正式开放回收策略支持。

      支持Delete、Retain回收策略,详情请参见PV回收策略。多个PV使用同一个文件存储时建议使用Retain,避免级联删除底层卷。

      Retain:删除PVC,PV资源与底层存储资源均不会被删除,需要手动删除回收。PVC删除后PV资源状态为“已释放(Released)”,不能直接再次被PVC绑定使用。

      Delete:表示删除PVC时,同时删除PV。

      storage

      PVC申请容量,单位为Gi。

      对文件存储来说,此处仅为校验需要(不能为空和0),设置的大小不起作用,此处设定为固定值1Gi。

      storageClassName

      存储类名称csi-nas,表示使用SFS 1.0容量型文件存储。

    2. 执行以下命令,创建PV。
      kubectl apply -f pv-sfs.yaml

  3. 创建PVC。

    1. 创建pvc-sfs.yaml文件。
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany                  # 文件存储必须为ReadWriteMany
        resources:
          requests:
            storage: 1Gi               # 文件存储大小
        storageClassName: csi-nas     # 存储类名称,必须与PV的存储类一致
        volumeName: pv-sfs    # PV的名称
      表7 关键参数说明

      参数

      是否必选

      描述

      storage

      PVC申请容量,单位为Gi。

      必须和已有PV的storage大小保持一致。

      storageClassName

      存储类名称,填写csi-nas,必须与1中PV的存储类一致,表示使用SFS 1.0容量型文件存储。

      volumeName

      PV的名称,必须与1中PV的名称一致。

    2. 执行以下命令,创建PVC。
      kubectl apply -f pvc-sfs.yaml

  4. 创建应用。

    1. 创建web-demo.yaml文件,本示例中将文件存储挂载至/data路径。
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    #卷名称,需与volumes字段中的卷名称对应
                mountPath: /data  #存储卷挂载的位置
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    #卷名称,可自定义
                persistentVolumeClaim:
                  claimName: pvc-sfs    #已创建的PVC名称
    2. 执行以下命令,创建一个挂载文件存储的应用。
      kubectl apply -f web-demo.yaml

      工作负载创建成功后,容器挂载目录下的数据将会持久化保持,您可以参考验证数据持久化及共享性中的步骤进行验证。

验证数据持久化及共享性

  1. 查看部署的应用及文件。

    1. 执行以下命令,查看已创建的Pod。
      kubectl get pod | grep web-demo
      预期输出如下:
      web-demo-846b489584-mjhm9   1/1     Running   0             46s
      web-demo-846b489584-wvv5s   1/1     Running   0             46s
    2. 依次执行以下命令,查看Pod的/data路径下的文件。
      kubectl exec web-demo-846b489584-mjhm9 -- ls /data
      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      两个Pod均无返回结果,说明/data路径下无文件。

  2. 执行以下命令,在/data路径下创建static文件。

    kubectl exec web-demo-846b489584-mjhm9 --  touch /data/static

  3. 执行以下命令,查看/data路径下的文件。

    kubectl exec web-demo-846b489584-mjhm9 -- ls /data

    预期输出如下:

    static

  4. 验证数据持久化

    1. 执行以下命令,删除名称为web-demo-846b489584-mjhm9的Pod。
      kubectl delete pod web-demo-846b489584-mjhm9

      预期输出如下:

      pod "web-demo-846b489584-mjhm9" deleted

      删除后,Deployment控制器会自动重新创建一个副本。

    2. 执行以下命令,查看已创建的Pod。
      kubectl get pod | grep web-demo
      预期输出如下,web-demo-846b489584-d4d4j为新建的Pod:
      web-demo-846b489584-d4d4j   1/1     Running   0             110s
      web-demo-846b489584-wvv5s    1/1     Running   0             7m50s
    3. 执行以下命令,验证新建的Pod中/data路径下的文件是否更改。
      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      预期输出如下:

      static

      static文件仍然存在,则说明数据可持久化保存。

  5. 验证数据共享性

    1. 执行以下命令,查看已创建的Pod。
      kubectl get pod | grep web-demo
      预期输出如下:
      web-demo-846b489584-d4d4j   1/1     Running   0             7m
      web-demo-846b489584-wvv5s   1/1     Running   0             13m
    2. 执行以下命令,在任意一个Pod的/data路径下创建share文件。本例中选择名为web-demo-846b489584-d4d4j的Pod。
      kubectl exec web-demo-846b489584-d4d4j --  touch /data/share
      并查看该Pod中/data路径下的文件。
      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      预期输出如下:

      share
      static
    3. 由于写入share文件的操作未在名为web-demo-846b489584-wvv5s的Pod中执行,在该Pod中查看/data路径下是否存在文件以验证数据共享性。
      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      预期输出如下:

      share
      static

      如果在任意一个Pod中的/data路径下创建文件,其他Pod下的/data路径下均存在此文件,则说明两个Pod共享一个存储卷。

相关操作

您还可以执行表8中的操作。
表8 其他操作

操作

说明

操作步骤

创建存储卷

通过CCE控制台单独创建PV。

  1. 在左侧导航栏选择“存储”,在右侧选择“存储卷”页签。单击右上角“创建存储卷”,在弹出的窗口中填写存储卷参数。
    • 存储卷类型:选择“文件存储”
    • 文件存储:单击“选择文件存储”,在新页面中勾选满足要求的文件存储,并单击“确定”
    • 子目录:选择是否使用子目录创建PV。请填写子目录绝对路径,例如/a/b,并确保子目录已存在且可用。
    • PV名称:输入PV名称,同一集群内的PV名称需唯一。
    • 访问模式:仅支持ReadWriteMany,表示存储卷可以被多个节点以读写方式挂载,详情请参见存储卷访问模式
    • 回收策略:Delete或Retain,详情请参见PV回收策略
      说明:

      多个PV使用同一个底层存储时建议使用Retain,避免级联删除底层卷。

    • 子目录回收策略:删除PVC时是否保留子目录,该参数需与PV回收策略配合使用,当使用子目录创建PV,且PV回收策略为"Delete"时支持配置。

      保留:删除PVC,PV会被删除,但PV关联的子目录会被保留

      删除:删除PVC,PV及其关联的子目录均会被删除

    • 挂载参数:输入挂载参数键值对,详情请参见设置文件存储挂载参数
  2. 单击“创建”

事件

查看PVC或PV的事件名称、事件类型、发生次数、Kubernetes事件、首次和最近发生的时间,便于定位问题。

  1. 在左侧导航栏选择“存储”,在右侧选择“存储卷声明”“存储卷”页签。
  2. 单击目标实例操作列的“事件”,即可查看1小时内的事件(事件保存时间为1小时)。

查看YAML

可对PVC或PV的YAML文件进行查看、复制和下载。

  1. 在左侧导航栏选择“存储”,在右侧选择“存储卷声明”“存储卷”页签。
  2. 单击目标实例操作列的“查看YAML”,即可查看或下载YAML。
提示

您即将访问非华为云网站,请注意账号财产安全

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容