文档中心

容器服务

存储

通过 FSX 挂载 EFS

本文为您介绍如何在 VCI 业务中通过 FSX 客户端使用 EFS 静态存储卷。

背景信息

VCI 支持通过 FSX 协议对接弹性文件存储（EFS），作为 EFS 高可用 POSIX（Portable Operating System Interface）文件系统客户端。通过此客户端，可将 EFS 存储挂载到 Linux 系统，使得存储可以作为 Linux 系统的本地文件系统，实现数据的存储和管理。

FSX 客户端相关介绍，请参见 FSX 客户端介绍。

使用限制

在 VCI 中通过 FSX 挂载 EFS 时，注意如下使用限制：

不支持临时 Token 鉴权。

有状态负载（StatefulSet）需要独占一个卷，暂不支持使用手动创建的存储卷声明。

EFS 存储卷仅支持部分地域，详情请参见 EFS 地域和可用区。

FSX 客户端当前仅支持 x86_64 架构，暂不支持在 Windows 和 macOS 环境使用，详情请参见运行环境。

前提条件

已创建 EFS 文件系统和接入点，详情请参见创建文件系统、管理接入点。

使用 IAM 身份（用户、角色）操作时，需要获取创建密钥所需的 AK/SK，用于挂载 EFS 存储。账号 AK/SK 获取方法，请参见 API 密钥（Access Key 与 API Key）。

使用 kubectl 命令行操作时，需要提前在本地安装 kubectl 工具，并通过 kubectl 连接目标集群。详细说明参见使用 kubectl 连接集群。

操作步骤

通过控制台配置

通过 kubectl 命令行配置

步骤一：创建存储卷（PV）

登录容器服务控制台。

在左侧导航栏中，选择集群。单击目标集群名称，进入集群管理页面。

在集群管理页面左侧导航栏中，选择存储管理 > 存储卷。

单击创建存储卷，在弹出的配置页面中，完成参数配置。

配置项	说明
创建方式	选择存储卷的创建方式，目前支持静态创建。
名称	根据系统提示，自定义存储卷的名称，需确保存储卷名称在集群内唯一。
存储类型	存储卷类型，本场景选择弹性文件存储。
访问类型	存储卷的访问类型，本场景选择 FSX。
访问模式	选择存储卷的访问方式，目前支持 ReadWriteMany ，此访问方式支持多点读写。
项目	为存储卷指定所属项目，从项目纬度管理集群资源的运维、授权等操作。默认选择 default（默认项目）。详情请参见项目管理。
接入点	选择已创建的 EFS 文件系统和与集群在同一个私有网络（VPC）内的接入点。
挂载路径	根据系统提示的输入规范，输入待挂载文件系统的子目录信息，默认为根目录/。说明需要保证将要挂载的子目录在 EFS 中已经存在。

单击确定，完成配置。

步骤二：创建存储卷声明（PVC）

在集群管理页面左侧导航栏中，选择存储管理 > 存储卷声明。

单击创建存储卷声明，在弹出的配置页面中，完成参数配置。

配置项	说明
命名空间	选择存储卷声明所属的命名空间。建议选择您自定义的命名空间，或系统默认创建的 default 命名空间。命名空间相关介绍，请参见命名空间概述。
名称	自定义存储卷声明的名称，需确保存储卷声明名称在集群内唯一。
存储类型	选择存储类型，本场景选择弹性文件存储。
访问模式	选择存储卷声明的访问方式，目前支持 ReadWriteMany，表示多点读写。
计费类型	按需选择资源计费类型，目前仅支持按量计费。
创建方式	配置存储卷声明的创建方式，本场景选择使用已有存储卷。
存储卷	指定已创建的存储卷进行关联挂载。

单击确定，完成配置。

步骤三：创建应用并挂载存储卷

EFS 文件存储卷创建完成后，可通过添加卷的方式挂载到工作负载使用，包括：无状态负载、有状态负载、任务、定时任务、守护进程。

可通过创建工作负载或更新工作负载操作的容器配置步骤，为工作负载添加卷并挂载卷。详细操作参见：工作负载。

已经连接集群的情况下，可通过 kubectl 命令行使用 EFS 静态存储卷。

步骤一：（可选）创建策略

说明

若使用主账号 AK/SK，可跳过此步骤。

创建策略的操作步骤，请参见新建自定义策略。其中，使用 IAM 身份挂载存储并执行相应操作时，相关参数配置说明和所需的权限，请参见配置接入点策略。

创建 EFS 策略的 JSON 示例如下所示。

{​
        "Statement": [​
            {​
                "Effect": "Allow",​
                "Action": [​
                    "efs:ClientMount",​
                    "efs:ClientWrite",​
                    "efs:ClientRootAccess"​
                ],​
                "Resource": ["trn:efs:<RegionId>:<AccountId>:filesystem/<FilesystemId>"],​
                "Condition": {​
                    "StringEquals": {​
                        "volc:RequestTag/accesspoint": "<接入点 ID>"​
                    }​
                }​
            },​
            {​
                "Effect": "Allow",​
                "Action": [​
                    "efs:VerifyAccessPoint",​
                    "efs:DescribeAccessPoints",​
                    "efs:CreateAccessPoint",​
                    "efs:ModifyAccessPoint",​
                    "efs:DeleteAccessPoint"​
                ],​
                "Resource": [​
                    "*"​
                ]​
            }​
        ]​
    }​

步骤二：创建存储卷（PV）

创建 PV 的 YAML 文件。示例文件vci-efs-fsx-static-pv.yaml的代码如下所示。

apiVersion: v1
kind: PersistentVolume
metadata:
name: vci-efs-static-pv # PV 名称。
spec:
capacity:
storage: 20Gi # 存储卷容量，仅用于校验，容量无实际意义。
accessModes:
- ReadWriteMany
csi:
driver: fsx.csi.volcengine.com # 驱动类型，本示例为 fsx.csi.volcengine.com，表示 csi-fsx 插件。
volumeHandle: vci-efs-static-pv # PV 的唯一标识符，与 PV 名称保持一致。如需同时使用多个 PV，则各个 PV 中该值必须不一致。
volumeAttributes:
type: efs # 存储卷类型，需配置为 efs。
server: ap-684b1***.cnshbe27***.3qda7dutskr***.cn-shanghai.efs.ivolces.com # EFS 文件系统接入点域名。
path: / # 挂载文件系统的子目录。
accessKey: xxx # Base 64 编码后的账号 AK，需要替换为真实信息。
secretKey: xxx # Base 64 编码后的账号 SK，与上述 AK 匹配，需要替换为真实信息。
mountOptions: rw # 存储挂载卷参数，当前支持：rw(默认，读写挂载)、ro（只读挂载）、access_key_id（账号 AK）、secret_access_key（账号 SK）、enable_xattr（扩展属性）。

执行以下命令，创建 PV。

kubectl create -f vci-efs-fsx-static-pv.yaml

步骤三：创建存储卷声明（PVC）

创建 PVC 的 YAML 文件。示例文件vci-efs-fsx-static-pvc.yaml的代码如下所示。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: vci-efs-static-pvc # PVC 名称。
namespace: default
spec:
accessModes:
- ReadWriteMany # PVC 访问模式。目前仅支持 ReadWriteMany，表示多点读写。
resources:
requests:
storage: 20Gi # 声明的存储使用量，仅用于校验，需要与 PV 的配置容量一致。
volumeMode: Filesystem # PV 类型，本示例填写 Filesystem，表示文件存储。
volumeName: vci-efs-static-pv # 绑定到该 PVC 的 PV 名称。

执行以下命令，创建 PVC。

kubectl create -f vci-efs-fsx-static-pvc.yaml

执行以下命令，查看 PVC 与 PV 的静态绑定结果。

kubectl get pvc

预期输出结果如下，表示 PVC 与 PV 静态绑定成功。

NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
vci-efs-fsx-static-pvc Bound vci-efs-fsx-static-pv 20Gi RWX 33s

步骤四：创建应用并挂载存储卷

创建 Deployment 的 YAML 文件。示例文件vci-efs-fsx-static-deployment.yaml的代码如下所示。

apiVersion: apps/v1
kind: Deployment
metadata:
name: vci-efs-static-deployment # Deployment 名称。
namespace: default # Deployment 所属命名空间。
labels:
app: nginx
spec:
replicas: 1
selector:
matchLabels:
app: vci-efs-static-deployment
template:
metadata:
labels:
app: vci-efs-static-deployment
spec:
containers:
- image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 容器镜像的地址和版本，请配置为您自己的镜像地址。若使用公网镜像，请确保您的集群能够访问公网。
imagePullPolicy: IfNotPresent
name: nginx
volumeMounts:
- mountPath: /tmp # EFS 在容器中挂载的位置。
name: fsx-pv
volumes:
- name: fsx-pv
persistentVolumeClaim:
claimName: vci-efs-static-pvc # 已创建的 PVC 名称。

执行以下命令，创建 Deployment。

kubectl create -f vci-efs-fsx-static-deployment.yaml

结果验证

按照上文示例创建工作负载并挂载存储卷后，您可以通过以下方式验证存储卷的挂载和持久化存储。

使用 kubectl 连接目标集群。详情请参见使用 kubectl 连接集群。

执行以下命令，查看存储卷是否正确挂载到 Pod 的指定路径。

kubectl exec vci-efs-static-deployment-xxx -- df | grep tmp

预期返回结果如下。

cnshbe27***.3qda7dutskr***.efs.ivolces.com:/ 10995116277760 0 10995116277760 0% /tmp

执行以下命令，查看 Pod 中的挂载路径，即查看存储卷中的数据。

kubectl exec vci-fsx-static-deployment-xxx -- ls /tmp

预期返回结果如下。

lost+found

执行以下命令，在存储卷中写入文件。

kubectl exec vci-fsx-static-deployment-xxx -- touch /tmp/test

执行以下命令，删除 Pod。

kubectl delete pod vci-fsx-static-deployment-xxx

执行以下命令，查看新创建 Pod 下的存储卷挂载路径。

kubectl exec vci-fsx-static-deployment-xxx -- ls /tmp

预期返回如下，可以看到存储卷中写入的文件依然存在，未随着 Pod 的删除而被删除，实现了数据的持久化存储。

lost+found
test

最近更新时间：2026.09.03 21:44:53

这个页面对您有帮助吗？

有用

无用