https://github.com/boltops-tools/lono

Lono CloudFormation Framework
https://github.com/boltops-tools/lono

aws boltops cloudformation lono lono-cloudformation

Last synced: 2 months ago
JSON representation

Lono CloudFormation Framework

• Host: GitHub
• URL: https://github.com/boltops-tools/lono
• Owner: boltops-tools
• License: apache-2.0
• Created: 2019-05-04T23:13:04.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-04-22T22:04:54.000Z (9 months ago)
• Last Synced: 2024-05-01T11:29:03.400Z (9 months ago)
• Topics: aws, boltops, cloudformation, lono, lono-cloudformation
• Language: Ruby
• Homepage: https://lono.cloud
• Size: 6.24 MB
• Stars: 47
• Watchers: 5
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


  



# Lono

![CodeBuild](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiYTloZ3dBZkZTYnlTaU1ZZTMvenROM1dmY2lDZzE0MDRVZ2d6NXdqb2JmSXNrQ3pkVGpKRTJMMnhTNDlOYUNOUlZZUmR6TktGcXRWMVFoYzhrSXFZWVZNPSIsIml2UGFyYW1ldGVyU3BlYyI6IkkrSGlFcTBWUjMzbk5xVGYiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)

[![Support](https://img.shields.io/badge/get-support-blue.svg)](https://boltops.com?utm_source=badge&utm_medium=badge&utm_campaign=lono)

[![BoltOps Badge](https://img.boltops.com/boltops/badges/boltops-badge.png)](https://www.boltops.com)

Please **watch/star** this repo to help grow and support the project.

Lono is a CloudFormation framework. It builds, manages, and deploys CloudFormation templates.

## Lono Features

* Simple CLI interface to launch CloudFormation stacks.

* Ability to use [Existing CloudFormation Templates](https://lono.cloud/docs/existing-templates/).

* [The Lono DSL](https://lono.cloud/docs/dsl/) - Generate templates from beautiful code.

* Write your CloudFormation parameters with [simple env-like values](https://lono.cloud/docs/config/params/).

* Preview CloudFormation changes before pressing the big red button.

* [Layering](https://lono.cloud/docs/core/layering/) - Allows you to build multiple environments like development and production with the same template.

* [Variables](https://lono.cloud/docs/layering/variables/) - Allows you to construct templates where runtime Parameters do not suffice.

* [Helpers](https://lono.cloud/docs/core/helpers/) - Allows you to extend Lono and simplify code.

* [Configsets](https://lono.cloud/docs/configsets/) - Configurement Management. Automatically configure EC2 instances with reuseable code.

See [lono.cloud](http://lono.cloud) for full lono documentation.

## Quick Usage

It only takes a couple of commands to start using lono.

    gem install lono --prerelease

    lono new project infra --examples

    cd infra

    lono up demo

![Lono flowchart](https://lono.cloud/img/tutorial/lono-flowchart.png "Lono flowchart")

## DSL

Here's an example of what the Lono CloudFormation DSL looks like:

```ruby

description "Demo stack"

parameter("InstanceType", "t3.micro")

mapping("AmiMap",

  "us-east-1": { Ami: "ami-0de53d8956e8dcf80" },

  "us-west-2": { Ami: "ami-061392db613a6357b" }

)

resource("Instance", "AWS::EC2::Instance",

  InstanceType: ref("InstanceType"),

  ImageId: find_in_map("AmiMap", ref("AWS::Region"), "Ami"),

  SecurityGroupIds: [get_att("SecurityGroup.GroupId")],

  UserData: base64(user_data("bootstrap.sh"))

)

resource("SecurityGroup", "AWS::EC2::SecurityGroup",

  GroupDescription: "demo security group",

)

output("Instance")

output("SecurityGroup", get_att("SecurityGroup.GroupId"))

```

### Lono Up

The `lono up` command deploys the CloudFormation stack.

    $ lono up demo

## 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