cloud_builder

KO | EN

gitlite — search

#python #typescript #llm #android #rust #linux #docker #macos #windows #awesome #kubernetes #mcp #ios #open-source

(★ 17)

Ruby DSL for managing AWS CloudFormation templates and stacks

cloud_builder Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CloudBuilder

Generates JSON config for AWS CloudFormation using a Ruby DSL. Manage CloudFormation stacks - create, update, diff.

Based on https://github.com/songkick/cloud_formatter

## Installation

Clone the repository, then run:

gem build cloud_builder.gemspec
    gem install cloud_builder-version.gem

## Usage

### CLI tool

$ stack --help
    Usage:
        stack [OPTIONS] STACK

Parameters:
        STACK                         stack to build

Options:
        -r, --region REGION           AWS region to use (default: $EC2_REGION, or "us-east-1")
        -v, --validate                validate the stack file before doing anything else
        -b, --bucket BUCKET           upload template to BUCKET (default: $CLOUD_BUILDER_BUCKET, or nil)
        -t, --diff-tool DIFF_TOOL     tool to use for diff (default: $CLOUD_BUILDER_DIFF_TOOL)
        -c, --create                  create the stack
        -u, --update                  update the stack
        -d, --diff                    do a diff between the existing template in BUCKET and the generated template
        -e, --estimate                estimate template cost
        -h, --help                    print help

For most actions you will require an active AWS account, so make sure you export `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to `ENV`

### Example stack

See stacks/example.rb for an example stack.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## Changelog

### 0.0.15
- add support for DependsOn resource attribute (see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html)

### 0.0.14
- change aws-sdk require to aws-sdk-v1

### 0.0.13
- add support for UpdatePolicy resource attribute (see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatepolicy.html)

### 0.0.12
- add --dummy flag; will add a dummy WaitConditionHandle to the stack to force updates in cases when only unused parameters or mappings are changed

### 0.0.11
- cli now uses AWS_DEFAULT_REGION instead of EC2_REGION

### 0.0.10
- publish gem homepage

### 0.0.9
- add support for DeletionPolicy resource attribute (see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html)
- remove debug puts in mappings.rb

### 0.0.8
- fix #3 Prevent creation of resources with the same name

### 0.0.7
- add license to gemspec

### 0.0.6
- added support for template Outputs (see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html)

### 0.0.5
- cli can use the EC2_REGION, CLOUD_BUILDER_BUCKET and CLOUD_BUILDER_DIFF_TOOL environment variables as defaults for `--region`, `--bucket` and `--diff-tool`
- deprecated the `--upload` flag/action, if you specify a bucket the stack json is uploaded by default

### 0.0.4
- support for specifying an AWS region

### 0.0.3
- add the Changelog
- AWS resources can have a Version property

### 0.0.2
- fix cloud_builder problem when using `--help`
- add DontFormatUnderscore class
- estimation should be done after uploading to s3 bucket
- add `--diff-tool` to specify a different tool to use for diffs

### 0.0.1
- beta initial release

cloud_builder

cloud_builder Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cloud_builder

cloud_builder Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README