cfn-hup 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7eca08152ac9d43ff3077b823ad00b037c9cca7a6cdb594ffdfb556a7dfb2758
+  data.tar.gz: b67f50d332910d04fa6293806ed683b60b9dd0f53b7c24c85a1a5fe0f359cc9f
+SHA512:
+  metadata.gz: 51ff3e5d4506c0b6ef8ea4dd497b1a06710f1b929aabe0b453bc3a470332ec2916cfb20b2640b79cd513f65ff469473cf4c32210472a606c26c93251039e29ee
+  data.tar.gz: 8cdb519221d8d88c6ef2c249859105601e8564704612c9469c689654051f257aef482acfbc1478fdebc95aa206188ce04cbd466b5e24090bec20f2308afe4b6e

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
+
+## [0.1.0]
+- Initial version

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in ssm_configset.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    cfn-hup (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    rake (10.5.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.0)
+      rspec-support (~> 3.9.0)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  cfn-hup!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.0.2

data/LICENSE.txt

@@ -0,0 +1 @@
+https://www.boltops.com/boltops-community-license

data/README.md

@@ -0,0 +1,47 @@
+# cfn-hup configset
+
+![CodeBuild](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiV3JyMHYvZHVPNlNORnloUVE1YzlNTWJkZUJmNmVtaXdvZ1pKV1U4SUUrcU9VcTVZdm5qbVA2cWdIdUZ0VEIraTVyaFpUajBpK2NvZmNFeTRWaEI1TnI0PSIsIml2UGFyYW1ldGVyU3BlYyI6IjZFRnpCNXh4ZEY3L2dqS00iLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
+
+[![BoltOps Badge](https://img.boltops.com/boltops/badges/boltops-badge.png)](https://www.boltops.com)
+
+## Why?
+
+Configsets are essentially configuration management. Use configsets to configure and update your EC2 instances automatically. Lono allows you to use configsets in a reusable way.
+
+Configsets work with [AWS::CloudFormation::Init](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html) and [cfn-init](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-init.html). Configsets do not magically get applied after being added to the CloudFormation template though.  The `cfn-init` script must be called to apply the configset.
+
+Usually the `cfn-init` script is called in the UserData script. This ensures configsets are applied when instances are launched.
+
+Additionally, the [cfn-hup](https://github.com/boltopspro/cfn-hup) script can be set up to apply configsets continuously.
+
+This configset configures and runs the cfn-hup daemon. The `cfn-auto-reloader.conf` is configured to detect changes every 1 minute.  When the stack [Metatdata AWS::CloudFormation::Init](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html) changes, cfn-hup detects this and updates the EC2 instance. This ensures that the EC2 instance will always be up-to-date.
+
+The cfn-hup configset should usually be one of the first things to be setup.
+
+## What are lono configsets?
+
+Lono configsets allow CloudFormation [cfn-init](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-init.html) [configsets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html) that are typically embedded in the template to be reusable.  More info: [Lono Configsets docs](https://lono.cloud/docs/configsets/).
+
+## Usage
+
+Use `configset` to enable the configset for the blueprint.  Example:
+
+configs/demo/configsets/base.rb:
+
+```ruby
+configset("cfn-hup", resource: "Instance")
+```
+
+This adds the configset to the `resource` with the logical id `Instance` in your CloudFormation template.  The configset is added to the [Resources[].Metadata.AWS::CloudFormation::Init](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-init.html) attribute of the `Instance` resource.
+
+Here's an example adding to a `LaunchConfig` resource:
+
+```ruby
+configset("cfn-hup", resource: "LaunchConfig")
+```
+
+Here's an example adding to a `LaunchTemplate` resource:
+
+```ruby
+configset("cfn-hup", resource: "LaunchTemplate")
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/cfn-hup.gemspec

@@ -0,0 +1,23 @@
+Gem::Specification.new do |spec|
+  spec.name          = "cfn-hup"
+  spec.version       = "0.1.0"
+  spec.authors       = ["Tung Nguyen"]
+  spec.email         = ["tung@boltops.com"]
+
+  spec.summary       = "cfn-hup configset: configures and ensures cfn-hup is running"
+  spec.homepage      = "https://github.com/boltopspro/cfn-hup"
+  spec.license       = "https://www.boltops.com/boltops-community-license"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/configset.yml

@@ -0,0 +1,36 @@
+AWS::CloudFormation::Init:
+  configSets:
+    default:
+    - cfn_hup
+  cfn_hup:
+    files:
+      "/etc/cfn/cfn-hup.conf":
+        content:
+          Fn::Sub:
+          - |
+            [main]
+            stack=${AWS::StackId}
+            region=${AWS::Region}
+            interval=1
+          - {}
+        mode: '000400'
+        owner: root
+        group: root
+      "/etc/cfn/hooks.d/cfn-auto-reloader.conf":
+        content:
+          Fn::Sub:
+          - |
+            [cfn-auto-reloader-hook]
+            triggers=post.update
+            path=Resources.<%= @resource %>.Metadata.AWS::CloudFormation::Init
+            action=/opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource <%= @resource %> --region ${AWS::Region}
+            runas=root
+          - {}
+    services:
+      sysvinit:
+        cfn-hup:
+          enabled: 'true'
+          ensureRunning: 'true'
+          files:
+          - "/etc/cfn/cfn-hup.conf"
+          - "/etc/cfn/hooks.d/cfn-auto-reloader.conf"

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: cfn-hup
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tung Nguyen
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-01-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- tung@boltops.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- cfn-hup.gemspec
+- lib/configset.yml
+homepage: https://github.com/boltopspro/cfn-hup
+licenses:
+- https://www.boltops.com/boltops-community-license
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: 'cfn-hup configset: configures and ensures cfn-hup is running'
+test_files: []