前提條件

• 已創建ACK Pro版集群，且集群版本為1.18及以上。具體操作，請參見創建ACK Pro版集群。

• 已安裝云原生AI套件并部署ack-fluid組件。具體操作，請參見安裝云原生AI套件。

  說明

  若安裝的ack-fluid組件已是最新版本，則無需執行升級操作。

• 已通過kubectl連接Kubernetes集群。具體操作，請參見通過kubectl工具連接集群。

步驟一：升級ack-fluid組件

1. 登錄容器服務管理控制臺，在左側導航欄選擇集群。

2. 在集群列表頁面，單擊目標集群名稱，然后在左側導航欄，選擇應用 > 云原生AI套件。

3. 在云原生AI套件頁面的組件列表中，單擊ack-fluid組件操作列下的升級。

   說明

   如果操作列下沒有升級字樣，說明當前的ack-fluid組件已是最新版本，無需升級。

4. 在升級組件對話框，單擊確定。

步驟二：驗證ack-fluid組件功能

建議在升級ack-fluid組件后進行功能驗證，以確保相關功能的兼容性。您可按照如下步驟進行兼容性驗證。

1. 根據業務需求選擇合適的Runtime類型，確保Runtime類型的資源已成功創建，并且相關配置已完成。具體操作，請參見JindoFS加速OSS文件訪問、EFC加速NAS或CPFS文件訪問。

2. 新建一個應用Pod，并將其掛載到升級前創建的Fluid Dataset自定義資源（CR），并確保該應用Pod能正常訪問數據。

3. 刪除之前創建的應用Pod，并刪除升級前創建的Fluid Dataset CR資源，并確保Fluid Dataset CR資源、Runtime CR資源以及緩存系統相關的資源能正常刪除。

4. 新建一個Fluid Dataset CR資源和Runtime CR資源，并確保兩者能夠綁定成功。可以通過查看資源狀態或者使用kubectl命令來確認綁定操作是否成功。

5. 新建一個應用Pod，并將其掛載到新建的Fluid Dataset CR資源，并確保該應用Pod能正常訪問數據。

6. 刪除之前創建的應用Pod，并刪除升級后新建的Fluid Dataset CR資源，并確保Fluid Dataset CR資源、Runtime CR資源以及緩存系統相關的資源能正常刪除。

常見問題

從低版本升級至v1.0.2及以上版本注意事項

ack-fluid v1.0.2版本對Fluid控制面組件的Helm后端存儲驅動進行了修改，以增強產品安全能力。該改動不會影響當前集群業務運行，但在刪除Fluid Dataset資源后可能造成集群內與Helm相關的部分Secret資源殘留。如果您需要對集群內殘留的Secret資源進行清理，可以通過以下Bash腳本鑒別集群內殘留的Secret資源。

解決方案

執行以下腳本，鑒別集群內殘留的Secret資源。

#!/bin/bash

tmpfile=$(mktemp)
kubectl get secret -A | awk '{if ($3 == "helm.sh/release.v1") print $1,$2}' > $tmpfile

fluid_chart_names=( "jindofs" "goosefs" "alluxio" "juicefs" "efc" "thin" "fluid-dataloader" "fluid-datamigrate" )

cat $tmpfile | while read -r x y
do
  chart_name=$(kubectl get secret -n $x $y -ojson | jq .data.release -r | base64 -d | base64 -d | gunzip - | jq .chart.metadata.name -r)
  if [[ " ${fluid_chart_names[*]} " =~ " ${chart_name} " ]]; then
    # e.g. sh.helm.release.v1.demo-dataset.v1
    dataset_name=${y#sh.helm.release.v1.}
    dataset_name=${dataset_name%.v1}
    kubectl get dataset -n $x $dataset_name &> /dev/null
    if [[ ! $? -eq 0 ]]; then
        echo "secret \"$x/$y\" is possibly not cleaned up. Use \"kubectl delete secret -n $x $y\" to clean it"
    fi
  fi
done

如果存在殘留的Secret資源，會輸出類似如下結果：

secret "default/sh.helm.release.v1.demo-dataset.v1" is possibly not cleaned up. Use "kubectl delete secret -n default sh.helm.release.v1.demo-dataset.v1" to clean it
secret "default/sh.helm.release.v1.thin-demo.v1" is possibly not cleaned up. Use "kubectl delete secret -n default sh.helm.release.v1.thin-demo.v1" to clean it

可以根據Secret名稱獲取到對應的Dataset名字信息，例如default/sh.helm.release.v1.demo-dataset.v1對應為default命名空間下名稱為demo-dataset的Dataset資源，通過以下命令確認上述Dataset是否存在：

kubectl get dataset -n <namespace> <dataset_name>

如果顯示類似如下結果，則說明Dataset已經被刪除：

Error from server (NotFound): datasets.data.fluid.io "<dataset_name>" not found

執行以下命令，刪除殘留的Secret資源：

kubectl delete secret <secret_name> -n <namespace>