README.md in cloudformation-ruby-dsl-0.4.5 vs README.md in cloudformation-ruby-dsl-0.4.6

- old
+ new

@@ -1,20 +1,20 @@ # cloudformation-ruby-dsl -A Ruby DSL and helper utilities for building Cloudformation templates dynamically. +A Ruby DSL and helper utilities for building CloudFormation templates dynamically. Written by [Bazaarvoice](http://www.bazaarvoice.com): see [the contributors page](https://github.com/bazaarvoice/cloudformation-ruby-dsl/graphs/contributors) and [the initial contributions](https://github.com/bazaarvoice/cloudformation-ruby-dsl/blob/master/initial_contributions.md) for more details. ## Motivation -Cloudformation templates often contain repeated stanzas, information which must be loaded from external sources, and other functionality that would be easier handled as code, instead of configuration. +CloudFormation templates often contain repeated stanzas, information which must be loaded from external sources, and other functionality that would be easier handled as code, instead of configuration. -Consider when a userdata script needs to be added to a Cloudformation template. Traditionally, you would re-write the script by hand in a valid JSON format. Using the DSL, you can specify the file containing the script and generate the correct information at runtime. +Consider when a userdata script needs to be added to a CloudFormation template. Traditionally, you would re-write the script by hand in a valid JSON format. Using the DSL, you can specify the file containing the script and generate the correct information at runtime. :UserData => base64(interpolate(file('userdata.sh'))) -Additionally, Cloudformation templates are just massive JSON documents, making general readability and reusability an issue. The DSL allows not only a cleaner format (and comments!), but will also allow the same DSL template to be reused as needed. +Additionally, CloudFormation templates are just massive JSON documents, making general readability and reusability an issue. The DSL allows not only a cleaner format (and comments!), but will also allow the same DSL template to be reused as needed. ## Installation Run `gem install cloudformation-ruby-dsl` to install system-wide. @@ -44,20 +44,27 @@ - `mapping(name, options)` - `condition(name, options)` - `resource(name, options)` - `output(name, options)` -### Cloudformation Function Calls +### CloudFormation Function Calls -Invoke a native Cloudformation function. +Invoke an intrinsic CloudFormation function. - `base64(value)` - `find_in_map(map, key, name)` - `get_att(resource, attribute)` - `get_azs(region)` - `join(delim, *list)` - `select(index, list)` - `ref(name)` -- `no_value()` + +Reference a CloudFormation pseudo parameter. +- `aws_account_id()` +- `aws_notification_arns()` +- `aws_no_value()` +- `aws_region()` +- `aws_stack_id()` +- `aws_stack_name()` ### Utility Functions Additional capabilities for file inclusion, etc. - `tag(tag)`: add tags to the stack, which are inherited by all resources in that stack; can only be used at launch