文件存储 NAS：管理AgenticSpace

场景一：在ECS上挂载

1. 在AgenticSpace列表中获取挂载地址。挂载地址即对应AgenticSpace接入点的NFS域名，挂载后视图自动限制在该AgenticSpace内。

2. 在ECS（Linux）安装NFS客户端：

   # CentOS / Alibaba Cloud Linux
   sudo yum install -y nfs-utils
   
   # Ubuntu / Debian
   sudo apt-get install -y nfs-common

3. 配置RAM AK/SK凭证（用于接入点鉴权）：

   sudo mkdir -p /etc/aliyun/alinas
   sudo tee /etc/aliyun/alinas/.credentials > /dev/null <<EOF
   [NASCredentials]
   accessKeyID = <子账号AK>
   accessKeySecret = <子账号SK>
   EOF

4. 执行挂载命令，并通过 df -h 验证：

   sudo mount -t alinas -o tls,vers=3,ram <挂载地址>:/ /mnt/agenticspace

场景二：在Agent Sandbox中通过CSI挂载

适用于在ACS集群中通过Agent Sandbox（SandboxSet/SandboxClaim）拉起的容器化Agent实例，将AgenticSpace作为持久化Workspace挂载到Sandbox容器。

前置条件

• 已开通容器计算服务ACS并创建ACS集群，集群与AgenticFS接入点在同一VPC。

• 已在ACS集群安装 ack-agent-sandbox-controller 组件，并通过SandboxSet完成沙箱预热池配置。详情请参见容器服务文档创建Agent Sandbox。

• 用于挂载的RAM子账号已按上文接入点（AccessPoint）中的策略示例完成授权。

步骤一：创建Secret与PV

将子账号AK/SK写入Secret，并创建指向AgenticSpace接入点的PV：

apiVersion: v1
kind: Secret
metadata:
  name: nas-secret
  namespace: sandbox-system
stringData:
  akId: <子账号AK>
  akSecret: <子账号SK>
---
apiVersion: v1
kind: PersistentVolume
metadata:
  name: nas-agenticspace-pv
  labels:
    alicloud-pvname: nas-agenticspace-pv
spec:
  capacity:
    storage: 500Gi
  accessModes:
    - ReadWriteMany
  csi:
    driver: nasplugin.csi.alibabacloud.com
    volumeHandle: nas-agenticspace-pv
    nodePublishSecretRef:
      name: nas-secret
      namespace: sandbox-system
    volumeAttributes:
      server: "<AgenticSpace接入点域名>"
      path: "/"
      vers: "3"
      mountprotocol: "alinas"
      filesystemtype: "standard"
  mountOptions:
  - tls,ram
  - vers=3

应用后执行 kubectl get pv，确认PV状态为 Available。

步骤二：通过SandboxClaim挂载

在SandboxClaim中通过 dynamicVolumesMount 引用上一步创建的PV，并指定容器内挂载路径：

apiVersion: agents.kruise.io/v1alpha1
kind: SandboxClaim
metadata:
  name: code-interpreter-claim
  namespace: default
spec:
  templateName: code-interpreter    # SandboxSet 名称
  replicas: 1
  claimTimeout: 5m
  ttlAfterCompleted: 15m
  dynamicVolumesMount:
  - pvName: nas-agenticspace-pv
    mountPath: "/workspace"

步骤三：验证挂载结果

查看SandboxClaim对应的Pod，进入容器验证挂载路径：

kubectl get sandbox -n default -l agents.kruise.io/claim-name=code-interpreter-claim
kubectl -n default exec -it <sandbox-pod-name> -- sh
df -h | grep workspace