Excluir pilhas de implantação
Está a aproximar-se do fim do sprint 3 para a nova aplicação de depósitos. Você aprendeu recentemente sobre como desanexar e excluir recursos de uma pilha de implantação. Ao planejar o próximo sprint, você deseja aprender 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á sobre como excluir pilhas de implantação.
Nota
Os comandos nesta unidade são mostrados para ilustrar conceitos. Não execute os comandos ainda. Você vai praticar o que você aprende 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, modelo JSON ARM ou 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 em um único 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 confiável de recursos. As pilhas de implantação permitem que você exclua a pilha e todos os seus recursos gerenciados por meio de uma única chamada de API, sem a necessidade de entender as dependências entre os recursos dentro da pilha. Esta única operação de exclusão remove os recursos de forma confiável e melhora a velocidade de remoção. Os recursos na pilha são excluídos de onde quer que estejam, mesmo que 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 create and update da pilha de implantação, o valor da ação no parâmetro unmanage 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 unmanage. Lembre-se de que o valor definido mais recentemente tem precedência.
Considere a aplicação de depósitos. Na unidade anterior, removemos alguns recursos de nossos arquivos Bicep e, em seguida, atualizamos a pilha de implantação para usar o arquivo Bicep revisado. Esta ação teve como consequência a retirada de alguns dos 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 a ação no parâmetro unmanage como , o delete allque exclui os recursos. Mas, às vezes, você deseja excluir a pilha sem excluir os recursos. Talvez você não precise mais dos recursos que as pilhas de implantação oferecem, mas os recursos precisam permanecer. Ou, você está movendo um recurso de uma pilha para outra. Para desanexar os recursos, defina a ação no parâmetro unmanage como detach all em vez disso.
Nota
Ao trabalhar com pilhas de implantação com escopo de grupo de recursos, o delete all valor da ação no parâmetro unmanage não dissuade os recursos desanexados ou o grupo de recursos onde a pilha existe. Se você quiser remover os recursos desanexados e o grupo de recursos, eles devem ser excluídos manualmente.
Para excluir uma pilha de implantação usando a CLI do Azure, use o az stack group delete comando.
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 Remove-AzResourceGroupDeploymentStack comando.
Remove-AzResourceGroupDeploymentStack `
-Name stack-deposits `
-ResourceGroupName rg-depositsApplication `
-ActionOnUnmanage -DeleteAll