Supprimer des piles de déploiement

Effectué

Vous approchez de la fin du sprint 3 pour la nouvelle application de dépôts. Vous avez récemment appris comment détacher et supprimer des ressources d’une pile de déploiement. Vous planifiez maintenant le sprint suivant, et souhaitez savoir comment supprimer une pile de déploiement et ce que cela signifie pour vos ressources managées et non managées.

Dans cette unité, vous allez découvrir comment supprimer des piles de déploiement.

Remarque

Les commandes de cette unité sont présentées pour illustrer les concepts. N’exécutez pas encore les commandes. Vous allez bientôt mettre en pratique ce que vous apprenez ici.

Supprimer une pile de déploiement

Une pile de déploiement est une ressource Azure native qui agit comme une série de pointeurs vers les ressources managées par la pile. Les ressources, également appelées ressources managées, sont définies dans un fichier Bicep, un modèle ARM JSON ou une spécification de modèle.

Lorsqu’une pile de déploiement n’est plus nécessaire, vous pouvez la supprimer. Mais pourquoi supprimer une pile de déploiement ? Peut-être que vous travaillez dans un environnement éphémère et que vous utilisez des piles de déploiement pour déployer et détruire l’environnement en une commande unique. Peut-être que vous déployez une nouvelle version de l’application et que vous devez supprimer la version précédente.

Comme indiqué dans le module d’introduction, l’un des avantages des piles de déploiement est la fiabilité du nettoyage des ressources. Les piles de déploiement vous permettent de supprimer la pile et toutes ses ressources managées au moyen d’un unique appel d’API, sans avoir à comprendre les dépendances entre les ressources dans la pile. Cette opération de suppression unique supprime les ressources de manière fiable, et améliore la vitesse de suppression. Les ressources de la pile sont supprimées où qu’elles se trouvent, même si elles chevauchent plusieurs groupes de ressources ou abonnements.

Qu’arrive-t-il aux ressources de la pile lorsque cette dernière est supprimée ? Comme avec les commandes de création et de mise à jour de la pile de déploiement, la valeur du paramètre action on unmanage détermine ce qui arrive aux ressources de la pile. La valeur de ce paramètre peut être définie lors de la création, de la modification ou de la suppression d’une pile de déploiement. Les trois opérations ont la possibilité de définir le comportement de l’action sur le paramètre unmanage. N’oubliez pas que la valeur définie le plus récemment est prioritaire.

Considérez l’application de dépôts. Dans l’unité précédente, nous avons supprimé certaines ressources de nos fichiers Bicep, puis nous avons mis à jour la pile de déploiement de façon à utiliser le fichier Bicep révisé. Cette action a eu pour conséquence de supprimer certaines de nos ressources. À présent, nous pouvons supprimer toute la pile, ce qui supprime toutes les ressources managées par la pile.

En règle générale, lors de la suppression d’une pile de déploiement, vous affectez la valeur delete all au paramètre action on unmanage, ce qui supprime les ressources. Mais parfois, vous souhaitez supprimer la pile sans supprimer les ressources. Il se peut par exemple que vous n’ayez plus besoin des fonctionnalités proposées par les piles de déploiement, mais que les ressources doivent être conservées. Ou peut-être déplacez-vous une ressource d’une pile vers une autre. Pour détacher les ressources, affectez plutôt la valeur detach all au paramètre action on unmanage.

Remarque

Lors de l’utilisation de piles de déploiement délimitées par le groupe de ressources, la valeur delete all du paramètre action on unmanage ne supprime pas les ressources détachées ni le groupe de ressources où la pile existe. Si vous souhaitez supprimer les ressources détachées et le groupe de ressources, vous devez le faire manuellement.

Pour supprimer une pile de déploiement à l’aide d’Azure CLI, utilisez la commande az stack group delete.

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

Pour supprimer une pile de déploiement à l’aide d’Azure PowerShell, utilisez la commande Remove-AzResourceGroupDeploymentStack.

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