移除 Azure 容器儲存體

本文說明如何從您的 Azure Kubernetes 服務(AKS)叢集中移除 Azure 容器儲存元件。 為了清理資源,你也可以刪除 AKS 叢集或整個資源群組。

這很重要

本文適用於 Azure 容器儲存體 (2.x.x 版)。 如果您的 AKS 叢集上已安裝 Azure 容器儲存體 (1.x.x 版),請遵循 下列步驟將其移除。

移除雲端儲存分散式加速器

在移除雲端儲存的分散式加速器之前:

  1. 停止或重新設定使用快取發現服務的工作負載。
  2. 確認具權威性的模型檔案和資料集存在於 Azure Blob 儲存體中。
  3. 停止執行中的暖機工作負載,或等候其完成。
  4. 如果您因故障而移除雲端儲存分散式加速器,請記錄診斷資訊。

在控制器仍在運行時刪除每個快取資源,以便讓控制器可以清理快取伺服器資源。 將這些值替換成你想移除的快取,並在移除控制器前對每個快取資源重複此步驟:

CACHE_NAMESPACE=<cache-namespace>
CACHE_NAME=<cache-name>

kubectl delete cache "$CACHE_NAME" --namespace "$CACHE_NAMESPACE" --wait=true
kubectl get cache --namespace "$CACHE_NAMESPACE"
kubectl get pods --namespace "$CACHE_NAMESPACE" --selector app=cacheserver

在停用管理擴充功能前,請確認所有快取資源和快取伺服器 Pods 都已被移除。 請勿直接解除安裝擴充功能的 Helm 版本。

停用受管理擴充功能

此擴充功能會管理 NVMe 必要元件 DaemonSet。 不要單獨移除那個 DaemonSet;停用 DACS 會移除它。

僅停用雲端儲存分散式加速器,並保留已安裝的 Azure 容器儲存體持續性磁碟區儲存體類型:

az aks update \
    --name <cluster-name> \
    --resource-group <resource-group> \
    --disable-azure-container-storage distributedAccelerator

停用 DACS 會移除其受控擴充功能、控制器,以及 kube-system 中由擴充功能管理的 NVMe 必要元件 DaemonSet,但會保留 Cache CRD。

驗證移除

此清理會移除臨時快取副本與 DACS 元件。 它不會刪除 Azure Blob 儲存體 中的原始模型檔案或資料集。

確認沒有快取資源或快取伺服器 pod 殘留,且控制器與受管理的前置守護程序已被移除:

kubectl get cache -A
kubectl get pods -A --selector app=cacheserver
kubectl get deployment dacs-manager --namespace kube-system --ignore-not-found
kubectl get daemonset dacs-prereq --namespace kube-system --ignore-not-found

確認不再有名為 distributedaccelerator 的擴充功能:

az k8s-extension list \
    --cluster-type managedClusters \
    --cluster-name <cluster-name> \
    --resource-group <resource-group> \
    --query "[?name=='distributedaccelerator'].{name:name,state:provisioningState}" \
    --output table

Warning

除非 Azure 支援指示你,否則不要手動刪除 DACS 的自訂資源定義(CRD)。 刪除 CRD 會刪除叢集中所有快取資源。

移除後,刪除僅供 DACS 使用的節點標籤、身分、角色指派、祕密以及其他工作負載未使用的監控規則。 不要在未檢查其其他用途前移除共用身分識別或 Blob 角色指派。

只有當快取命名空間是專門用於 DACS 且沒有需要保留的資源時,才刪除該快取命名空間。

移除整個 Azure 容器儲存裝置(安裝程式和 CSI 驅動程式)

在解除安裝擴充功能前,請刪除所有永續性磁碟區宣告 (PVC) 和永續性磁碟區 (PV)。 移除 Azure 容器儲存卻未清理這些資源,可能會干擾正在運行的工作負載。 在繼續之前,請確保沒有任何工作負載或 StorageClass 物件依賴 Azure 容器儲存。

請執行以下 Azure CLI 指令,完全移除 Azure 容器儲存。 以您自己的值取代 <cluster-name> 和 <resource-group>。

az aks update -n <cluster-name> -g <resource-group> --disable-azure-container-storage

用 Terraform 移除擴充功能

如果你用 Terraform 配置了 Azure 容器儲存,請從配置中移除對應的擴充資源,並套用變更,使結果與 CLI 工作流程相符。

  1. 刪除 azurerm_kubernetes_cluster_extension Terraform 設定中的區塊(或設定 count = 0)並儲存檔案。

  2. 檢視計畫,確認 Terraform 只會摧毀擴充資源。

    terraform plan
    
  3. 執行計畫刪除該擴展。 Terraform 顯示的結果與 CLI 指令相同:擴充資源被移除,且 AKS 不再報告 Azure 容器儲存已啟用。

    terraform apply
    

重新啟用 Azure 容器儲存體

如果你之前移除了一種或多種儲存類型的 CSI 驅動程式,可以透過執行以下 Azure CLI 指令重新啟用該儲存類型。

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-type>

預期行為:

  • 指定儲存類型是可選的。 如果沒有提供儲存類型,則只會安裝 Azure 容器儲存安裝元件(如果還沒有的話)。
  • 當指定儲存類型時,會安裝對應的 CSI 驅動程式。 如果該儲存類型的 StorageClass 已經存在,則只會安裝驅動程式;否則,安裝過程中會建立一個預設的 StorageClass。

刪除 AKS 叢集

若要刪除 AKS 叢集和所有永續性磁碟區,請執行下列 Azure CLI 命令。 以您自己的值取代 <resource-group> 和 <cluster-name>。

az aks delete --resource-group <resource-group> --name <cluster-name>

AKS 通常在刪除叢集時會刪除其管理節點資源群組。 若另外檢查該群組是否已不存在時傳回 Forbidden,請記錄驗證尚未完成:此錯誤無法證明該群組存在或不存在。 如有需要,請具有該節點資源群組讀取權限的系統管理員驗證移除情形。 叢集資源群組的空白清單無法驗證該獨立節點資源群組不存在。

如果 AKS 叢集是用 Terraform 建立的,你也可以執行以下指令移除它。

terraform destroy

此指令會刪除 Terraform 目前工作目錄中管理的所有資源。 這包括叢集、資源群組以及 Azure 容器儲存擴充功能。 只有在你打算移除整個部署時才執行此指令。

刪除資源群組

您也可以使用 az group delete 命令來刪除資源群組及其包含的所有資源。 將 <resource-group> 取代為您的資源群組名稱。

az group delete --name <resource-group>

另請參閱