The forest-fire package

[ Tags: 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]

Properties

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
Dependencies aeson, base (>=4.7 && <5), bytestring, cli, containers, forest-fire, process, text [details]
License BSD3
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 repository head: git clone https://github.com/toothbrush/forest-fire
Uploaded Sat Oct 14 02:51:01 UTC 2017 by toothbrush
Distributions
Executables forest-fire
Downloads 220 total (120 in the last 30 days)
Rating 0.0 (0 ratings) [clear rating]
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2017-10-14 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for forest-fire-0.2.1

[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

You'll need the following installed and available to be able to use 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

To download and install the utility, simply run:

stack 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.