Ta bort distributionsstackar

Slutförd

Du närmar dig slutet av sprint 3 för det nya inlåningsprogrammet. Du har nyligen lärt dig hur du kopplar bort och tar bort resurser från en distributionsstack. När du planerar för nästa sprint vill du lära dig hur du tar bort en distributionsstack och vad det innebär för dina hanterade och ohanterade resurser.

I den här lektionen lär du dig att ta bort distributionsstackar.

Kommentar

Kommandona i den här enheten visas för att illustrera begrepp. Kör inte kommandona än. Du kommer att öva på det du lär dig här snart.

Ta bort en distributionsstack

En distributionsstack är en intern Azure-resurs som fungerar som en serie pekare till de resurser som stacken hanterar. Resurserna, även kallade hanterade resurser, definieras i en Bicep-fil, ARM JSON-mall eller mallspecifikation.

När en distributionsstack inte längre behövs kan du ta bort den. Men varför ta bort en distributionsstack? Du kanske arbetar i en tillfällig miljö och använder distributionsstackar för att distribuera och ta bort miljön i ett enda kommando. Du kanske distribuerar en ny version av programmet och behöver ta bort den tidigare versionen.

Som beskrivs i introduktionsmodulen är en av fördelarna med distributionsstackar tillförlitlig resursrensning. Med distributionsstackar kan du ta bort stacken och alla dess hanterade resurser via ett enda API-anrop, utan att behöva förstå beroendena mellan resurser i stacken. Den här enkla borttagningsåtgärden tar bort resurserna på ett tillförlitligt sätt och förbättrar borttagningshastigheten. Resurser i stacken tas bort var de än befinner sig, även om de omfattar flera resursgrupper eller prenumerationer.

Vad händer med stackens resurser när den tas bort? Precis som med kommandona för att skapa och uppdatera distributionsstacken avgör värdet för åtgärden för ohanterade parametrar vad som händer med stackens resurser. Den här parameterns värde kan anges när du skapar, ändrar eller tar bort en distributionsstack. Alla tre åtgärderna har möjlighet att ange beteendet för åtgärden på ohanterad parameter. Tänk på att den senaste värdeuppsättningen har företräde.

Överväg inlåningsprogrammet. I föregående lektion tog vi bort vissa resurser från våra Bicep-filer och uppdaterade sedan distributionsstacken för att använda den reviderade Bicep-filen. Den här åtgärden fick till följd att vissa av våra resurser togs bort. Nu kan vi ta bort hela stacken, vilket tar bort alla resurser som stacken hanterar.

När du tar bort en distributionsstack anger du vanligtvis åtgärden för ohanterad parameter till delete all, som tar bort resurserna. Men ibland vill du ta bort stacken utan att ta bort resurserna. Du kanske inte längre behöver de funktioner som distributionsstackar erbjuder, men resurserna måste finnas kvar. Eller så flyttar du en resurs från en stack till en annan. Om du vill koppla från resurserna anger du åtgärden för ohanterad parameter till detach all i stället.

Kommentar

När du arbetar med resursgruppsomfångsdistributionsstackar delete all kommer värdet för åtgärden för ohanterade parametern inte att avlägsna de frånkopplade resurserna eller resursgruppen där stacken finns. Om du vill ta bort de frånkopplade resurserna och resursgruppen måste de tas bort manuellt.

Om du vill ta bort en distributionsstack med Hjälp av az stack group delete Azure CLI använder du kommandot .

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

Om du vill ta bort en distributionsstack med Azure PowerShell använder du Remove-AzResourceGroupDeploymentStack kommandot .

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