Platform For AI：靈駿智算本機快取加速

確定預熱連接埠

每個緩衝配置項對應一個獨立的預熱連接埠，連接埠範圍為10070~10079：

發起資料預熱

在同一Quota下的DSW或DLC執行個體中，執行以下命令發起預熱：

預熱API可在同一Quota下的DSW或DLC執行個體中直接調用（DSW執行個體預設具有所需角色許可權）。

# 如果getDataCacheService 的response 中isShareded = true 則使用如下命令：
curl -s "http://<CacheServiceId>-svc-0.t<主帳號id>.svc.cluster.local.<clusterId>.t<主帳號id>:<Port>/v1/warmup/load?target_path=<path1>,<path2>&pattern=<glob_pattern>"

# 其餘情況則使用如下命令：
curl -s "http://<CacheServiceId>.t<主帳號id>.svc.cluster.local.<clusterId>.t<主帳號id>:<Port>/v1/warmup/load?target_path=<path1>,<path2>&pattern=<glob_pattern>"

參數說明：

• isShareded：在控制台Quota詳情頁的本機快取頁簽，按F12進入檢查頁面，查看getDataCacheService介面的response，即可看到isShareded欄位的值。

• CacheServiceId：通過GetQuota介面查詢目標資源配額資訊，從主Quota（第一級資源配額）的返回結果中擷取CacheServiceId。

• 主帳號id：在控制台右上方，單擊帳戶圖片可查看主帳號ID。

• clusterId：同isShareded，在getDataCacheService介面的response中可查看到該值。

• Port：第一步中確定的預熱連接埠。

• target_path：需要預熱的資料路徑，支援多個路徑以逗號分隔。必須為掛載目錄下的相對路徑。例如，若需預熱BMCPFS上的/path1/path2，則target_path=path1/path2。

• pattern（可選）：檔案匹配模式，支援Regex。例如pattern=.*.txt表示僅預熱.txt尾碼的檔案。

樣本：

# 預熱掛載目錄下 dataset/train 中所有 .txt 檔案
curl -s "http://cacheservice-xxxx:t10953*******.svc.cluster.local.ca076dea628***********.t10953*******:10070/v1/warmup/load?target_path=dataset/train&pattern=.*.txt"

查詢預熱狀態

使用以下命令查詢預熱進度：

# 如果getDataCacheService 的response 中isShareded = true 則使用如下命令：
curl -s "http://<CacheServiceId>-svc-0.t<主帳號id>.svc.cluster.local.<clusterId>.t<主帳號id>:<Port>/v1/warmup/stat?target_path=<path1>,<path2>&preceding_time=<minutes>"

# 其餘情況則使用如下命令：
curl -s "http://<CacheServiceId>.t<主帳號id>.svc.cluster.local.<clusterId>.t<主帳號id>:<Port>/v1/warmup/stat?target_path=<path1>,<path2>&preceding_time=<minutes>"

參數說明：

• target_path：與預熱請求中的路徑一致。

• preceding_time：查詢最近N分鐘內的預熱狀態，單位為分鐘。

樣本：

# 查詢最近 10 分鐘內 dataset/train 的預熱狀態
curl -s "http://cacheservice-xxxx:t10953*******.svc.cluster.local.ca076dea628***********.t10953*******:10070/v1/warmup/stat?target_path=dataset/train&preceding_time=10"

注意事項

• 預熱API僅可在與快取服務同一Quota下的DSW或DLC執行個體中調用。

• target_path必須使用掛載目錄下的相對路徑，不要使用絕對路徑。

• 如果存在多級嵌套的資源配額，請確認CacheServiceId來自第一級資源配額（主Quota）。

• 預熱操作為非同步執行，可通過/v1/warmup/stat介面持續跟蹤進度。