刪除部署堆疊

已完成

新存款應用程式的第 3 個開發衝刺週期。 您最近學習了如何從部署堆疊中斷連結及刪除資源。 規劃下一個開發衝刺週期時,不妨學習如何刪除部署堆疊,及其對受控和非受控資源的意義。

在本單元,您將學習如何刪除部署堆疊。

注意

本單元中的命令僅用於示範概念。 請先不要執行命令。 您很快就會在此練習所學到的內容。

刪除部署堆疊

部署堆疊是原生 Azure 資源,可當成堆疊所管理資源的一系列指標。 這些資源也稱為受控資源,定義位於 Bicep 檔案、ARM JSON 範本或範本規格。

部署堆疊再也用不到時可以刪除。 然而,刪除部署堆疊的原因為何? 或許您目前在暫時的環境工作,並使用部署堆疊以單一命令部署及完全移除環境。 或許您打算部署新版本的應用程式,必須移除舊版。

如簡介課程模組討論的內容所述,以可靠的方式清除資源是部署堆疊的優點之一。 部署堆疊可讓您透過單一 API 呼叫刪除堆疊及其所有受控資源,而且不需要理解堆疊內資源之間的相依性。 這個單一刪除作業以可靠的方式移除資源,並且提升移除的速度。 即使堆疊內的資源跨越多個資源群組或訂用帳戶也會刪除,不受位置限制。

堆疊的資源刪除時會發生什麼事? 跟部署堆疊會建立及更新命令一樣,unmanage 參數上動作的值,也會決定堆疊資源會發生什麼事。 建立、修改或刪除部署堆疊時,可以設定這個參數的值。 這三個作業都能設定 action on unmanage 參數的行為。 請記住,最近設定的值優先。

請仔細思考存款應用程式的例子。 在前一個單元中,我們從 Bicep 檔案移除了一些資源,然後將部署堆疊更新為使用修訂後的 Bicep 檔案。 這個動作接著會移除部分資源。 現在,我們可以刪除整個堆疊,將堆疊管理的所有資源都移除。

一般而言,刪除部署堆疊時會將 unmanage 參數上的動作設定為 delete all,而且該動作會刪除資源。 然而,有時候您想刪除堆疊,但不想刪除資源。 也許您以後用不到部署堆疊所提供的功能,但需要保留資源。 或者,您想將資源從一個堆疊移至另一個堆疊。 若要中斷連結資源,請改為將 unmanage 參數上的動作設定為 detach all

注意

處理資源群組範圍的部署堆疊時,unmanage 參數上動作delete all 值,不會清除卸離的資源或堆疊所在的資源群組。 如果您想移除中斷連結的資源和資源群組,則必須手動刪除。

若要使用 Azure CLI 刪除部署堆疊,請使用 az stack group delete 命令。

az stack group delete \
    --name stack-deposits \
    --resource-group rg-depositsApplication \
    --action-on-unmanage deleteAll

若要使用 Azure PowerShell 刪除部署堆疊,請使用 Remove-AzResourceGroupDeploymentStack 命令。

Remove-AzResourceGroupDeploymentStack `
    -Name stack-deposits `
    -ResourceGroupName rg-depositsApplication `
    -ActionOnUnmanage -DeleteAll