Skip to content

A tool for managing the launch of complex CloudFormation stacks

License

Notifications You must be signed in to change notification settings

agperson/hygroscope

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gem Version Code Climate


hy·gro·scope
ˈhīɡrəˌskōp/, noun
an instrument that gives an indication of the humidity of the air.


Hygroscope is a Thor-based command-line tool for managing the launch of complex CloudFormation stacks.

CloudFormation is a great way to manage infrastructure resources using code, but it has some aspects that make it a pain:

  1. Templates must be written in JSON, which, in addition to being difficult for a human to read, does not support niceties such as inline comments and repeated blocks.
  2. Launching CloudFormation stacks requires knowledge of the various parameters that need to be provided, and it is difficult to repeatably launch a stack since parameters are not saved in any convenient way.
  3. There is no easy mechanism to send a payload of data to an instance during stack creation (for instance scripts and recipes to bootstrap an instance).
  4. Finally, it is difficult to launch stacks that build upon already-existing stacks (i.e. an application stack within an existing VPC stack) because one must manually provide a variety of identifiers (subnets, IP addresses, security groups).

Hygroscope aims to solve each of these specific problems in an opinionated way:

  1. CF templates are written in YAML and processed using cfoo, which provides a variety of convenience methods that increase readability.
  2. Hygroscope can interactively prompt for each parameter and save inputted parameters to a file called a paramset. Additional stack launches can make use of existing paramsets, or can use paramsets as the basis and prompt for updated parameters.
  3. A payload directory, if present, will be packaged and uploaded to S3. Hygroscope will generate and pass to CF a signed time-limited URL for accessing and downloading the payload, or the CloudFormation template can manage an instance profile granting indefinite access to the payload.
  4. If an existing stack is specified, its outputs will be fetched and passed through as input parameters when launching a new stack.

Hygroscope can be installed via RubyGems. Run hygroscope help to view inline command documentation and options. See template structure for information about the format of hygroscopic templates.

About

A tool for managing the launch of complex CloudFormation stacks

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages