Excluir pilhas de implantação
Você está perto do final do sprint 3 para o novo aplicativo de depósitos. Você aprendeu recentemente como desanexar e excluir recursos de uma pilha de implantação. Enquanto você planeja o próximo sprint, aprenda sobre como excluir uma pilha de implantação e o que isso significa para seus recursos gerenciados e não gerenciados.
Nesta unidade, você aprenderá a excluir pilhas de implantação.
Observação
Os comandos nesta unidade são mostrados para ilustrar conceitos. Não execute os comandos ainda. Você praticará o que aprendeu aqui em breve.
Excluir uma pilha de implantação
Uma pilha de implantação é um recurso nativo do Azure que atua como uma série de ponteiros para os recursos que a pilha gerencia. Os recursos, também conhecidos como recursos gerenciados, são definidos em um arquivo Bicep, um modelo JSON do ARM ou uma especificação de modelo.
Quando uma pilha de implantação não é mais necessária, você pode excluí-la. Mas por que excluir uma pilha de implantação? Talvez você esteja trabalhando em um ambiente efêmero e use pilhas de implantação para implantar e derrubar o ambiente com apenas um comando. Talvez você esteja implantando uma nova versão do aplicativo e precise remover a versão anterior.
Conforme discutido no módulo de introdução, um dos benefícios das pilhas de implantação é a limpeza de recursos confiável. As pilhas de implantação permitem excluir a pilha e todos os seus recursos gerenciados por meio de apenas uma chamada à API, sem a necessidade de entender as dependências entre os recursos dentro da pilha. Essa operação de exclusão individual remove os recursos de maneira confiável e aprimora a velocidade de remoção. Os recursos na pilha são excluídos de onde quer que estejam, mesmo que eles abranjam vários grupos de recursos ou assinaturas.
O que acontece com os recursos da pilha quando ela é excluída? Assim como acontece com os comandos de criação e atualização da pilha de implantação, o valor do parâmetro ação ao cancelar gerenciamento determina o que acontece com os recursos da pilha. O valor desse parâmetro pode ser definido ao criar, modificar ou excluir uma pilha de implantação. Todas as três operações têm a capacidade de definir o comportamento da ação no parâmetro deixar de gerenciar. Lembre-se de que o valor definido mais recentemente tem precedência.
Considere o aplicativo de depósitos. Na unidade anterior, removemos alguns recursos de nossos arquivos Bicep e atualizamos a pilha de implantação para usar o arquivo Bicep revisado. Essa ação teve como consequência a remoção de alguns de nossos recursos. Agora, podemos excluir toda a pilha, o que remove todos os recursos que a pilha gerencia.
Normalmente, ao excluir uma pilha de implantação, você define o parâmetro ação ao cancelar gerenciamento como delete all, o que exclui os recursos. Mas, às vezes, você deseja excluir a pilha sem excluir os recursos. Talvez você não precise mais das funcionalidades que as pilhas de implantação oferecem, mas os recursos precisam permanecer. Ou então, você está movendo um recurso de uma pilha para outra. Para desanexar os recursos, defina o parâmetro ação ao cancelar gerenciamento como detach all em vez disso.
Observação
Ao trabalhar com pilhas de implantação no escopo do grupo de recursos, o valor delete all do parâmetro ação ao cancelar gerenciamento não exclui os recursos desanexados ou o grupo de recursos em que a pilha existe. Se você quiser remover os recursos desanexados e o grupo de recursos, eles precisarão ser excluídos manualmente.
Para excluir uma pilha de implantação usando a CLI do Azure, use o comando.az stack group delete.
az stack group delete \
--name stack-deposits \
--resource-group rg-depositsApplication \
--action-on-unmanage deleteAll
Para excluir uma pilha de implantação usando o Azure PowerShell, use o comando.Remove-AzResourceGroupDeploymentStack.
Remove-AzResourceGroupDeploymentStack `
-Name stack-deposits `
-ResourceGroupName rg-depositsApplication `
-ActionOnUnmanage -DeleteAll