forest-fire: Recursively delete CloudFormation stacks and their dependants

[ bsd3, library, program, silly-tool ] [ Propose Tags ]

This simple tool will repeatedly query CloudFormation stacks for outputs, and see if any other stacks are importing those. This is to make it easier to tear down CFn stacks which have many other stacks depending on their outputs.


[Skip to Readme]
Versions 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.1.0, 0.1.1.1, 0.2, 0.2.1, 0.2.2, 0.3
Dependencies aeson, base (>=4.7 && <5), bytestring, cli, containers, forest-fire, process, text [details]
License BSD-3-Clause
Copyright Copyright: (c) 2017 Paul
Author Paul
Maintainer paul.david@redbubble.com
Category silly tool
Home page https://github.com/toothbrush/forest-fire#readme
Source repo head: git clone https://github.com/toothbrush/forest-fire
Uploaded by toothbrush at Wed Dec 27 04:43:48 UTC 2017
Distributions NixOS:0.3
Executables forest-fire
Downloads 1603 total (24 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2017-12-27 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for forest-fire-0.3

[back to package description]

forest-fire Build Status

This is a little command-line tool with an ill-advised name, to easily tear down CloudFormation stacks which have outputs that other stacks depend on. In the AWS Console this is rather annoying, since you have to manually chase up dependencies.

This tool simply interrogates the aws-cli tool about the stack you're trying to delete, finds out its outputs, and checks whether any currently-active stacks are importing them. The output is a dependency tree, which trivially tells us the order of deletion for it to succeed. If you're feeling adventurous, you may also let forest-fire do the actual deletion for you.

Installation

Prerequisites for hacking

You'll need the following installed and available to be able to hack on this software:

Haskell Stack

You'll want to install Stack using your local package manager (yes, it's available on Homebrew as haskell-stack), or if you're adventurous, using their curl | bash method...

You'll need to add ~/.local/bin to your $PATH.

AWS CLI interface

I'm guessing that this is a thing you'll already have.

Instructions

If you're not interested in hacking on this project, you can simply download and install it. Run:

cabal update; cabal install forest-fire

Usage

If you simply run the tool without arguments, it'll print usage information. Here's the down-low, however.

Find out what depends on a stack

Note that this performs a dry run (read-only). The dependency tree will be printed, along with the order in which you'd have to perform deletions, but nothing will be executed.

forest-fire "kubernetes-dynamic-91acf0ef-lifecycle"

Perform the deletions if you're satisfied with the tree

forest-fire "kubernetes-dynamic-91acf0ef-lifecycle" --delete

Do you Docker?

Some people don't believe in native executables. For them, i present the Docker version:

docker container run --rm \
    -e AWS_SECRET_ACCESS_KEY \
    -e AWS_ACCESS_KEY_ID \
    -e AWS_DEFAULT_REGION \
    paulrb/forest-fire:master yourstack

It is hosted on Docker Hub: https://hub.docker.com/r/paulrb/forest-fire and built with Travis CI: https://travis-ci.org/toothbrush/forest-fire from this repository.

Credits

Thanks Redbubble, i totally should've been doing other things instead of shaving this yak.