File Storage NAS:AgenticSpace の管理

制限事項

• AgenticFS ファイルシステムが必要です。現在、AgenticFS ファイルシステムを作成できるのは、許可リストに登録されているアカウントのみです。この機能を使用するには、チケットを送信してください。

• 1 つの AgenticFS で最大 500,000 の AgenticSpace をサポートします。1 つの AgenticSpace で最大 1 PiB の容量と 10 億個のファイルをサポートします。

• パスは名前変更やシンボリックリンクをサポートしていません。ネストされた AgenticSpace はサポートされていません。

• Linux 上の NFS v3 のみをサポートします。SMB および Windows はサポートされていません。AgenticSpace は、ECS インスタンスや Container Compute Service (ACS) の Agent サンドボックスなど、NFS v3 をサポートする任意の Linux コンピュートノードにマウントできます。

AgenticSpace の作成

コンソールまたは OpenAPI を使用して AgenticSpace を作成できます。AgenticSpace を作成する際には、パスとクォータを指定する必要があります。次の表に、主要なパラメーターを示します。

方法 1：コンソールを使用

1. NAS コンソールにログインし、対象の AgenticFS ファイルシステムの [AgenticSpace] タブに移動します。

2. [AgenticSpace の作成] をクリックし、上記の表に従ってパラメーターを指定し、フォームを送信します。

方法 2：OpenAPI を使用

CreateAgenticSpace API を呼び出します。次のコードはリクエストの例です。

POST /AgenticSpace/Create HTTP/1.1
Host: nas.aliyuncs.com
Content-Type: application/json

{
"FileSystemId":"031*******",
"FileSystemPath":"/test5/",
"RegionId":"cn-shanghai",
"Azone":"cn-shanghai-f",
"Quota.SizeLimit":"110595407872",
"Quota.FileCountLimit":100004
}

クォータの表示と変更

[AgenticSpace] リストでは、パス、可用性ゾーン、容量のクォータと使用量、ファイル数のクォータと使用量、作成時刻などのフィールドを表示できます。容量とファイル数のクォータを調整するには、対象の AgenticSpace の [操作] 列にある [編集] をクリックします。また、SetAgenticSpaceQuota 操作を呼び出すこともできます。

アクセスポイント

アクセスポイントは AgenticFS の NFS プロトコルエントリポイントであり、マウントターゲット、権限チェック、トラフィック分離を提供します。AgenticFS は、2 つの粒度レベルでアクセスポイントをサポートします。

• AgenticFS レベル：AgenticFS のルートディレクトリをターゲットとします。このレベルは、プラットフォーム操作や OpenAPI による AgenticSpace の一括管理など、信頼できるシナリオ向けです。AgenticFS ルートディレクトリのマウントは、現在のバージョンではサポートされていません。

• AgenticSpace レベル：アクセスポイントは単一の AgenticSpace をターゲットとします。マウント後、クライアントのビューは対応する AgenticSpace に制限されます。これは、エージェントセッションを起動するための標準的なエントリポイントです。

RAM アクセス権限

アクセスポイントは RAM ベースのアクセスポリシーをサポートしており、どのアプリケーション、RAM ユーザー、または RAM ロールが特定の AgenticFS ファイルシステムや AgenticSpace にアクセスできるかを制御します。RAM ユーザーに nas:ClientMount 権限を付与し、nas:AccessPointArn 条件を使用してマウント可能なアクセスポイントを制限することを推奨します。次のポリシーは一例です。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "nas:ClientMount"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "nas:AccessPointArn": "acs:nas:*:*:accesspoint/ap-xxxxxx"
        }
      }
    }
  ]
}

Mount an AgenticSpace

1. Get the mount target from the AgenticSpace list.

2. On your ECS (Linux) instance, install the NFS client:

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

3. Run the mount command and verify the result by using the df -h command:

   sudo mount -t ALINAS -o tls,vers=3,ram <mount-target>:/ /mnt

AgenticSpace のマウント

AgenticSpace は、2 つの典型的なシナリオでマウントできます。ALINAS クライアントを使用して ECS インスタンスに直接マウントする方法、または Agent サンドボックス (SandboxClaim) を使用して ACS クラスターに CSI ボリュームとしてマウントする方法です。どちらのシナリオでも、「アクセスポイント」セクションに記載の RAM 権限が必要です。また、コンピュートノードは AgenticFS アクセスポイントと同じ VPC 内にある必要があります。

注：現在のバージョンでは、AgenticSpace のみがマウント可能です。AgenticFS ルートディレクトリのマウントはサポートされていません。

apiVersion: v1
kind: Secret
metadata:
  name: nas-secret
  namespace: sandbox-system
stringData:
  akId: <YourAccessKeyID>
  akSecret: <YourAccessKeySecret>
---
apiVersion: v1
kind: PersistentVolume
metadata:
  name: nas-agenticspace-pv
  labels:
    alicloud-pvname: nas-agenticspace-pv
spec:
  capacity:
    storage: 500 Gi
  accessModes:
    - ReadWriteMany
  csi:
    driver: nasplugin.csi.alibabacloud.com
    volumeHandle: nas-agenticspace-pv
    nodePublishSecretRef:
      name: nas-secret
      namespace: sandbox-system
    volumeAttributes:
      server: "<AgenticSpace_access_point_domain>"
      path: "/"
      vers: "3"
      mountprotocol: "alinas"
      filesystemtype: "standard"
  mountOptions:
  - tls,ram
  - vers=3

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"

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

AgenticSpace の削除

AgenticSpace を削除するには、管理リストで対象のスペースの [アクション] 列にある [削除] をクリックするか、DeleteAgenticSpace 操作を呼び出します。AgenticSpace が削除されると、同じパスに新しい AgenticSpace を作成できます。

よくある質問

マウント時に "access denied" エラーが表示されるのはなぜですか？

ECS インスタンスと AgenticFS が同じ VPC 内にあることを確認してください。

データ書き込み時に "no space" エラーが表示されるのはなぜですか？

このエラーは、容量またはファイル数クォータの上限に達した場合に発生します。これを解決するには、クォータを増やすか、AgenticSpace 内のファイルを削除してスペースを解放します。

これは現在サポートされていません。新しい AgenticSpace を作成し、アプリケーションレイヤーでデータをコピーする必要があります。

SMB または Windows を使用して AgenticSpace にアクセスできますか？

AgenticFS は現在、NFS v3 プロトコルと Linux クライアントのみをサポートしています。