rain
Interactive AWS CloudFormation deployment tool
TLDR
List all CloudFormation stacks in the current region
SYNOPSIS
rain command [options] [arguments]
DESCRIPTION
rain is a development workflow tool for AWS CloudFormation that simplifies template authoring, validation, and stack management. It provides a more user-friendly interface than the standard AWS CLI for CloudFormation operations.
Key improvements over the AWS CLI include live deployment progress with colored output, automatic template formatting, template comparison, and deployment failure prediction. Rain can detect potential issues before deployment, saving time and reducing failed stack operations.
The tool supports CloudFormation modules and can package local artifacts like Lambda code for deployment. It handles the complexity of S3 bucket management for artifacts automatically.
PARAMETERS
ls
List CloudFormation stacks or changesets in the current regiondeploy template stack-name
Deploy a CloudFormation stack from a local templatecat stack-name
Retrieve and display the template of a running stacklogs stack-name
Show the event log for the specified stackrm stack-name
Delete a CloudFormation stackfmt template
Format CloudFormation templates to a consistent stylediff template1 template2
Compare two CloudFormation templatesbuild resource-type
Create CloudFormation templates for specified resource typesforecast template stack-name
Predict potential deployment failurespkg template
Package local artifacts for deployment (replacement for aws cloudformation package)bootstrap
Create the S3 artifacts bucket for deployments--region, -r region
Specify AWS region--profile, -p profile
Use a specific AWS profile--experimental, -x
Enable experimental commands--help, -h
Display help information
CAVEATS
Requires AWS credentials configured via environment variables, AWS CLI profiles, or IAM roles. Ensure the AWS account has appropriate CloudFormation and related service permissions.
Some commands like forecast are experimental and require the -x flag. Experimental features may change between versions.
Rain operates on one region at a time. Use --region to specify a different region than the default.
HISTORY
Rain was developed by the AWS CloudFormation team and released as an open-source tool to improve the CloudFormation development experience. The name is a play on "what happens when you have a lot of CloudFormation." It is written in Go and actively maintained on GitHub.
