README.md in lono-5.0.1 vs README.md in lono-5.1.0
- old
+ new
@@ -2,11 +2,12 @@
<img src="http://lono.cloud/img/logos/lono-logo-small.png" />
</div>
# Lono
-![CodeBuild](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiaHF3Y2pqSVBlZ0JMdXhPL010bTI2cVd6SkpHQWlLRkJ5SHlCcDFueUtHVFNCVFZyWEVZd01yWDZ1VjZCRjNVQ1F4d2JlTlJOWDRtU3R3NkJzVkJKSHJ3PSIsIml2UGFyYW1ldGVyU3BlYyI6IkZIRVZwM00rQzQxcDJWaVMiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
+![CodeBuild](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiYTloZ3dBZkZTYnlTaU1ZZTMvenROM1dmY2lDZzE0MDRVZ2d6NXdqb2JmSXNrQ3pkVGpKRTJMMnhTNDlOYUNOUlZZUmR6TktGcXRWMVFoYzhrSXFZWVZNPSIsIml2UGFyYW1ldGVyU3BlYyI6IkkrSGlFcTBWUjMzbk5xVGYiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
+[![CircleCI](https://circleci.com/gh/tongueroo/lono.svg?style=svg)](https://circleci.com/gh/tongueroo/lono)
[![Support](https://img.shields.io/badge/get-support-blue.svg)](https://boltops.com?utm_source=badge&utm_medium=badge&utm_campaign=lono)
Lono is a powerful CloudFormation framework. Lono handles the entire CloudFormation lifecycle. It builds, manages and deploys CloudFormation templates.
* Lono generates CloudFormation templates based on a [DSL](http://lono.cloud/docs/dsl/).
@@ -35,29 +36,29 @@
Here's an example of what the Lono CloudFormation DSL looks like:
```ruby
description "Demo stack"
-parameter(:instance_type, "t3.micro")
+parameter("InstanceType", "t3.micro")
-mapping(:ami_map,
+mapping("AmiMap",
"us-east-1": { ami: "ami-0de53d8956e8dcf80" },
"us-west-2": { ami: "ami-061392db613a6357b" }
)
-resource(:instance, "AWS::EC2::Instance",
- instance_type: ref(:instance_type),
- image_id: find_in_map(:ami_map, ref("AWS::Region"), :ami),
- security_group_ids: [get_att("security_group.group_id")],
+resource("Instance", "AWS::EC2::Instance",
+ instance_type: ref("InstanceType"),
+ image_id: find_in_map("AmiMap", ref("AWS::Region"), :ami),
+ security_group_ids: [get_att("SecurityGroup.GroupId")],
user_data: base64(user_data("bootstrap.sh"))
)
-resource(:security_group, "AWS::EC2::SecurityGroup",
+resource("SecurityGroup", "AWS::EC2::SecurityGroup",
group_description: "demo security group",
)
-output(:instance)
-output(:security_group, get_att("security_group.group_id"))
+output("Instance")
+output("SecurityGroup", get_att("SecurityGroup.GroupId"))
```
### Lono Cfn Lifecycle Commands
Lono provides a `lono cfn` lifecycle command that allows you to launch stacks quickly. The `lono cfn` tool automatically runs `lono generate` internally and then launches the CloudFormation stack all in one command. If you are in a lono project and have a `demo` lono blueprint. To create a stack you can simply run:
@@ -66,13 +67,12 @@
The above command will generate files to `output/infra/templates/demo.yml` and `output/infra/params/demo.txt` and use them to create a CloudFormation stack. Here are some more examples of cfn commands:
lono cfn deploy demo # shorthand if blueprint, template and params file matches.
lono cfn deploy demo-$(date +%Y%m%d%H%M%S) --blueprint demo --template demo --param demo
- lono cfn diff demo-1493859659
- lono cfn preview demo-1493859659
- lono cfn update demo-1493859659
- lono cfn delete demo-1493859659
+ lono cfn diff demo
+ lono cfn preview demo
+ lono cfn delete demo
lono cfn deploy -h # getting help
See [lono.cloud](http://lono.cloud) for full lono documentation.
## Contributing