Quick Start

In a hurry? No problem! Here’s a quick start to using lono that takes only a few minutes.

gem install lono

Now we’re ready to create and launch some infrastructure. The commands below launches a CloudFormation stack with an EC2 Instance and Security Group.

lono new infra
cd infra
lono cfn deploy demo

Congratulations! You have successfully created a CloudFormation stack with lono. It’s that simple. 😁

What Just Happened?

Here’s a little more details to help understand what happened. We first installed lono and generated a new lono project called infra:

$ lono new infra
=> Creating new project called infra.
=> Creating new blueprint called demo.
=> Initialize git repo
=> Installing dependencies with: bundle install
Congrats  You have successfully created a lono project.  A starter demo blueprint was created
and is at blueprints/demo.  Check things out by going into the created infra folder.

  cd infra

To generate the blueprint templates without launching a stack, you can run:

  lono generate demo

The generated files are created at `output/demo/templates` and `output/demo/params`.

To deploy the CloudFormation stack:

  lono cfn deploy my-demo --blueprint demo

If you name the stack according to conventions, you can simply run:

  lono cfn deploy demo

To list and create additional blueprints refer to https://lono.cloud/docs/core/blueprints

More info: http://lono.cloud/

Then we went into the infra project folder and deployed the demo stack:

$ cd infra
$ lono cfn deploy demo

The command lono cfn deploy demo does a few things:

  1. Generate templates and params files using the blueprint in blueprints/demo.
  2. The templates and parameters files are written to output/demo/templates and output/demo/params.
  3. Launches the CloudFormation stack.

The example launches an EC2 instance with a security group. Check out the newly launch stack in the AWS console:

Stack Created

Pro tip: Use the <- and -> arrow keys to move back and forward.

Edit this page

See a typo or an error? You can improve this page. This website is available on GitHub and contributions are encouraged and welcomed. We love pull requests from you!