lono 3.5.0 → 4.0.0

data/lib/starter_projects/autoscaling/config/params/base/autoscaling.txt

@@ -0,0 +1,6 @@
+VpcId=
+Subnets=
+OperatorEMail=
+KeyName=
+#InstanceType=        # optional
+#SSHLocation=         # optional

data/lib/starter_projects/autoscaling/config/settings.yml

@@ -0,0 +1,33 @@
+# More info: http://lono.cloud/docs/settings/
+# The base config is specially treated. It gets included the other environments automatically.
+# Yaml also directly supports merging with & and <<* syntax but doing it automatically
+# for a cleaner syntax.
+base:
+  # http://lono.cloud/docs/app-scripts/
+  # extract_scripts:
+  #   to: "/opt"
+  #   as: "ec2-user"
+  # If s3_folder is set then the generated templates and app/scripts will automatically
+  # be uploaded to s3.
+  # There are 2 formats for s3_folder:
+  # Format 1:
+  # s3_folder: mybucket/path/to/folder # simple string
+  # Format 2:
+  # s3_folder: # Hash options in order to support multiple AWS_PROFILEs
+  #   default: mybucket/folder
+  #   aws_profile1: mybucket/folder
+  #   aws_profile2: another-bucket/storage/folder
+  # randomize_stack_name: true # tack on a 3 char random string at the end of the stack name for lono cfn create
+
+
+development:
+  # When you have AWS_PROFILE set to one of these values, lono will switch to the desired
+  # environment. This prevents you from switching AWS_PROFILE, forgetting to
+  # also switch LONO_ENV, and accidentally deploying to production vs development.
+  # aws_profiles:
+  #   - dev_profile1
+  #   - dev_profile2
+
+production:
+  # aws_profiles:
+  #   - prod_profile

data/lib/starter_projects/ec2/.gitignore

@@ -0,0 +1 @@
+output

data/lib/starter_projects/{json_project → ec2}/Guardfile

@@ -8,5 +8,5 @@ end
 
 # Commented out due to CF rate limiting
 # guard "cloudformation", templates_path: "output" do
-#   watch(%r{^output/.+\.json$})
+#   watch(%r{^output/.+\.yml$})
 # end

data/lib/starter_projects/ec2/README.md

@@ -0,0 +1,86 @@
+# Autoscaling Lono Example
+
+## Usage
+
+Create a new project.
+
+```
+TEMPLATE=ec2 lono new ec2
+cd ec2
+```
+
+Edit `config/params/base/ec2.txt` with your desired parameters. Here are the current contents of ``config/params/base/ec2.txt`:
+
+```sh
+InstanceType=t2.micro
+KeyName=default
+```
+
+Then launch the stack:
+
+```sh
+lono cfn create ec2
+```
+
+## How This Example Was Orginally Built
+
+First, generate a skeleton starter lono project.
+
+```sh
+TEMPLATE=skeleton lono new ec2
+```
+
+Then import a standard CloudFormation template into lono. The `--name` option is used to name the template `ec2`.
+
+```
+$ lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2
+=> Imported CloudFormation template and lono-fied it.
+Template definition added to app/definitions/base.rb
+Params file created to config/params/base/ec2.txt
+Template downloaded to app/templates/ec2.yml
+=> CloudFormation Template Summary:
+Parameters:
+Required:
+  KeyName (AWS::EC2::KeyPair::KeyName)
+Optional:
+  InstanceType (String) Default: t2.small
+  SSHLocation (String) Default: 0.0.0.0/0
+Resources:
+  1 AWS::EC2::Instance
+  1 AWS::EC2::SecurityGroup
+  2 Total
+Here are contents of the params config/params/base/ec2.txt file:
+KeyName=
+#InstanceType=        # optional
+#SSHLocation=         # optional
+```
+
+The template was imported from [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/sample-templates-services-us-west-2.html#w2ab2c23c48c13c15).
+
+A starter `config/params/base/ec2.txt` was generated with required parameters emptied and optional parameters commented out.  Fill in the required parameters.
+
+### Filling in the Parameters
+
+You can use the following commands to set KeyName to a key that exists on your AWS account.  Here we use `default` :
+
+```
+sed "s/KeyName=/KeyName=default/" config/params/base/ec2.txt > config/params/base/ec2.txt.1
+mv config/params/base/ec2.txt{.1,}
+```
+
+Now launch the stack:
+
+```
+lono cfn create ec2
+```
+
+## Commands Summarized
+
+```sh
+lono new ec2
+cd ec2
+lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2
+sed "s/KeyName=/KeyName=default/" config/params/base/ec2.txt > config/params/base/ec2.txt.1
+mv config/params/base/ec2.txt{.1,}
+lono cfn create ec2 --template ec2
+```

data/lib/starter_projects/ec2/app/definitions/base.rb

@@ -0,0 +1,2 @@
+template "example"
+

data/lib/starter_projects/ec2/app/definitions/development.rb

@@ -0,0 +1 @@
+# resources that only exist in the development environment

data/lib/starter_projects/ec2/app/definitions/production.rb

@@ -0,0 +1 @@
+# resources that only exist in the production environment

data/lib/starter_projects/{json_project/templates/user_data/app.sh → ec2/app/partials/user_data/bootstrap.sh}

@@ -1,5 +1,4 @@
 #!/bin/bash -lexv
-<% stack_name = "#{@env}-#{@app}-#{@role}" %>
 exec > >(tee /var/log/user-data.log|logger -t user-data -s 2>/dev/console) 2>&1
-echo <%= stack_name %> > /tmp/stack_name
+echo ${AWS::StackName}  > /tmp/stack_name
 cat /proc/uptime | cut -f1 -d'.' > /tmp/time-to-boot

data/lib/starter_projects/ec2/config/params/development/example.txt

@@ -0,0 +1,3 @@
+# parameters in here override parameters/base/example.txt for LONO_ENV=development
+# Also, config/variables are available in params files
+InstanceType=<%= @instance_type %>

data/lib/starter_projects/ec2/config/params/production/example.txt

@@ -0,0 +1,2 @@
+# parameters in here override parameters/base/example.txt for LONO_ENV=production
+InstanceType=t2.large

data/lib/starter_projects/ec2/config/settings.yml

@@ -0,0 +1,33 @@
+# More info: http://lono.cloud/docs/settings/
+# The base config is specially treated. It gets included the other environments automatically.
+# Yaml also directly supports merging with & and <<* syntax but doing it automatically
+# for a cleaner syntax.
+base:
+  # http://lono.cloud/docs/app-scripts/
+  # extract_scripts:
+  #   to: "/opt"
+  #   as: "ec2-user"
+  # If s3_folder is set then the generated templates and app/scripts will automatically
+  # be uploaded to s3.
+  # There are 2 formats for s3_folder:
+  # Format 1:
+  # s3_folder: mybucket/path/to/folder # simple string
+  # Format 2:
+  # s3_folder: # Hash options in order to support multiple AWS_PROFILEs
+  #   default: mybucket/folder
+  #   aws_profile1: mybucket/folder
+  #   aws_profile2: another-bucket/storage/folder
+  # randomize_stack_name: true # tack on a 3 char random string at the end of the stack name for lono cfn create
+
+
+development:
+  # When you have AWS_PROFILE set to one of these values, lono will switch to the desired
+  # environment. This prevents you from switching AWS_PROFILE, forgetting to
+  # also switch LONO_ENV, and accidentally deploying to production vs development.
+  # aws_profiles:
+  #   - dev_profile1
+  #   - dev_profile2
+
+production:
+  # aws_profiles:
+  #   - prod_profile

data/lib/starter_projects/ec2/config/variables/base.rb

@@ -0,0 +1,3 @@
+@ami = "ami-123"
+@override = "base"
+@instance_type = "t2.micro"

data/lib/starter_projects/ec2/config/variables/development.rb

@@ -0,0 +1,2 @@
+# variables in here override variables/base.rb for LONO_ENV=development
+@override = "development-override"

data/lib/starter_projects/ec2/config/variables/production.rb

@@ -0,0 +1,2 @@
+# variables in here override variables/base.rb for LONO_ENV=production
+@override = "production-override"

data/lib/starter_projects/ec2/welcome.txt

@@ -0,0 +1,8 @@
+The example template uses a keypair named default. Be sure that keypair exists.  Or you can adjust the KeyName parameter in config/params/base/example.txt. Here are contents of the file:
+
+  InstanceType=t2.micro
+  KeyName=default
+
+To launch an example CloudFormation stack:
+
+  lono cfn create example

data/lib/starter_projects/skeleton/.gitignore

@@ -0,0 +1 @@
+output

data/lib/starter_projects/skeleton/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem 'lono'

data/lib/starter_projects/skeleton/Guardfile

@@ -0,0 +1,12 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard "lono" do
+  watch(%r{^config/lono.rb$})
+  watch(%r{^templates/.*$})
+end
+
+# Commented out due to CF rate limiting
+# guard "cloudformation", templates_path: "output" do
+#   watch(%r{^output/.+\.yml$})
+# end

data/lib/starter_projects/skeleton/README.md

@@ -0,0 +1,53 @@
+# Lono CloudFormation Starter README
+
+This folder contains the code that represents your infrastructure built with CloudFormation.
+
+## Overview
+
+The CloudFormations templates are generated by a tool called [lono](http://lono.cloud/).
+
+## Updating the Infrastructure
+
+The general steps to update the infrastructure:
+
+1. Edit the files in this repo
+2. Generate the CloudFormation templates
+3. Update the stack with the changes
+
+Steps 2-3 are automated with lono and performed together with:
+
+```bash
+lono cfn update STACK_NAME --iam --sure
+```
+
+## Generating the templates
+
+If you would like to just generate the templates and not update the CloudFormation stack you can do so with:
+
+```
+lono generate
+```
+
+## Importing Templates
+
+You can also get started quickly by importing other CloudFormration templates into lono.  For example:
+
+```
+lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2
+```
+
+After importing edit the generated param file in the `config/params/base` folder. Then you can launch the stack:
+
+```
+lono cfn create ec2
+```
+
+## More help
+
+You can get help by adding `-h` to the end of commands.
+
+```sh
+lono cfn update -h
+```
+
+Help is also provided in the [Lono Docs](http://lono.cloud/docs/directory-structure/).

data/lib/starter_projects/skeleton/config/settings.yml

@@ -0,0 +1,33 @@
+# More info: http://lono.cloud/docs/settings/
+# The base config is specially treated. It gets included the other environments automatically.
+# Yaml also directly supports merging with & and <<* syntax but doing it automatically
+# for a cleaner syntax.
+base:
+  # http://lono.cloud/docs/app-scripts/
+  # extract_scripts:
+  #   to: "/opt"
+  #   as: "ec2-user"
+  # If s3_folder is set then the generated templates and app/scripts will automatically
+  # be uploaded to s3.
+  # There are 2 formats for s3_folder:
+  # Format 1:
+  # s3_folder: mybucket/path/to/folder # simple string
+  # Format 2:
+  # s3_folder: # Hash options in order to support multiple AWS_PROFILEs
+  #   default: mybucket/path
+  #   aws_profile1: mybucket/path
+  #   aws_profile2: another-bucket/storage/path
+  # randomize_stack_name: true # tack on a 3 char random string at the end of the stack name for lono cfn create
+
+
+development:
+  # When you have AWS_PROFILE set to one of these values, lono will switch to the desired
+  # environment. This prevents you from switching AWS_PROFILE, forgetting to
+  # also switch LONO_ENV, and accidentally deploying to production vs development.
+  # aws_profiles:
+  #   - dev_profile1
+  #   - dev_profile2
+
+production:
+  # aws_profiles:
+  #   - prod_profile

data/lib/starter_projects/skeleton/welcome.txt

@@ -0,0 +1,7 @@
+Add and edit templates to your project.  When you are ready to launch a CloudFormation stack run:
+
+  lono cfn create STACK_NAME
+
+You can also get started quickly by importing other CloudFormration templates into lono.  For example:
+
+  lono import https://s3-us-west-2.amazonaws.com/cloudformation-templates-us-west-2/EC2InstanceWithSecurityGroupSample.template --name ec2

data/lono.gemspec

@@ -4,32 +4,34 @@ require_relative "lib/lono/version"
 Gem::Specification.new do |gem|
   gem.authors       = ["Tung Nguyen"]
   gem.email         = ["tongueroo@gmail.com"]
-  gem.description   = %q{Lono is a CloudFormation Template ruby generator.  Lono generates CloudFormation templates based on ERB templates.}
   gem.summary       = %q{Lono is a CloudFormation Template ruby generator.  Lono generates CloudFormation templates based on ERB templates.}
   gem.homepage      = "http://github.com/tongueroo/lono"
 
   files = `git ls-files`.split($\) + Dir.glob("vendor/**/*")
   files = files.reject { |p| p =~ /^docs/ }
   gem.files         = files
-  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.bindir        = "exe"
+  gem.executables   = gem.files.grep(%r{^exe/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features|docs)/})
   gem.name          = "lono"
   gem.require_paths = ["lib"]
   gem.version       = Lono::VERSION
   gem.license       = "MIT"
 
-  gem.add_dependency "json"
-  gem.add_dependency "thor"
+  gem.add_dependency "activesupport"
+  gem.add_dependency "aws-sdk-cloudformation"
+  gem.add_dependency "aws-sdk-s3"
+  gem.add_dependency "colorize"
+  gem.add_dependency "filesize"
+  gem.add_dependency "graph" # lono graph command dependency
   gem.add_dependency "guard"
-  gem.add_dependency "rb-fsevent"
   gem.add_dependency "guard-cloudformation"
   gem.add_dependency "guard-lono"
-  gem.add_dependency "colorize"
   gem.add_dependency "hashie"
-  gem.add_dependency "aws-sdk-cloudformation"
-  gem.add_dependency "aws-sdk-s3"
-  gem.add_dependency "activesupport"
-  gem.add_dependency "graph" # lono inspect depends
+  gem.add_dependency "json"
+  gem.add_dependency "rb-fsevent"
+  gem.add_dependency "thor"
+  gem.add_dependency "render_me_pretty"
   # gem.add_dependency "plissken" # dependency for vendor/lono-params
   # using the vendor fork version: https://github.com/tongueroo/plissken
   # until https://github.com/futurechimp/plissken/pull/6 gets merged

data/spec/fixtures/lono_project/.gitignore

@@ -0,0 +1 @@
+output

data/spec/fixtures/lono_project/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem 'lono'

data/spec/fixtures/lono_project/Guardfile

@@ -0,0 +1,12 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard "lono" do
+  watch(%r{^config/lono.rb$})
+  watch(%r{^templates/.*$})
+end
+
+# Commented out due to CF rate limiting
+# guard "cloudformation", templates_path: "output" do
+#   watch(%r{^output/.+\.yml$})
+# end

data/spec/fixtures/lono_project/app/definitions/base.rb

@@ -0,0 +1,10 @@
+template "example" # simple single ec2 instance
+
+# template "parent"
+# template "network"
+# template "autoscaling" do
+#   source "asg"
+#   variables(
+#     root_volume_size: "8"
+#   )
+# end

data/spec/fixtures/lono_project/app/definitions/base/more.rb

@@ -0,0 +1,7 @@
+# more template declaration examples
+# This time in the base folder
+
+# simple single ec2 instance
+template "subfolder/example" do
+  source "example"
+end