Project

kitchen-sparkleformation

0.0
No release in over 3 years
Low commit activity in last 3 years
kitchen-sparkleformationdevkid/kitchen-sparkleformationHomepageDocumentationSource CodeBug TrackerWiki
Kitchen driver for creating CloudFormation stacks using SparkleFormation templates
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
2,445
Stars
2
Forks
1
Watchers
3
 Releases
Current version
0.1.0
Total releases
1
First release
2017-05-11
Latest release
2017-05-11
 Development
Primary Language
Ruby
Licenses
GPL-2.0
Average date of last 50 commits
2017-07-08
Reverse Dependencies
0

 Dependencies

Runtime

aws-sdk
< 3, >= 2
sparkle_formation
< 4, >= 3
 Project Readme

SparkleFormation driver for test-kitchen

Installation

Put this in your Gemfile:

gem 'kitchen-sparkleformation'

and run:

$ bundle

Usage

.kitchen.yml configuration:

driver:
  name: sparkleformation
  stack_name: kitchen-test
  stack_name_random_suffix: true
  sparkle_packs:
    - some_sparkle_pack
  sparkle_template: my_template_name
  upload_template: true
  s3_region: us-west-1
  s3_bucket: some-bucket
  s3_path: cloudformation/kitchen-tmp
  cf_params:
    some_parameter: some_value
  cf_options:
    :disable_rollback: true

Configuration

Option Description Default Value Required?
stack_name The name of the CloudFormation stack to create. yes
stack_name_random_suffix If true, append a random suffix string to the given stack name. false
sparkle_path The path to a directory containing your SparkleFormation template files. 'sparkleformation'
sparkle_template The name of the SparkleFormation template to use. yes
sparkle_state A hash of compile time parameters that are passed to SparkleFormation. {}
sparkle_packs Array of SparklePacks to load before compiling the template. []
upload_template If true, upload the template to S3. Requires s3_region, s3_bucket. false true if using nested templates
s3_region Region of given S3 bucket. if upload_template is true
s3_bucket Name of an S3 bucket where templates are uploaded to. if upload_template is true
s3_path Path in the S3 bucket where templates are uploaded to. if upload_template is true
hostname_output Extract the hostname of an instance from the value of the given output. no
hostname_resource The stack resource to use to extract the hostname from. no
hostname_attribute The attribute of a the given stack resource to extract the hostname from. Can be '<physical_resource_id>' to use the Physical ID of the given stack resource (e.g. Route53 record). no
cf_params Runtime parameters to pass to CloudFormation stack. {} no
cf_options Additional options to pass to CloudFormation stack creation. See here. {} no

If neither hostname_output nor hostname_resource is given, the first EC2 instance in the stack is used to extract the hostname.

If hostname_attribute is set to something other than '<physical_resource_id>', the given hostname_resource must be an EC2 instance. See here for a list of available attributes. By default, private_ip_address is used.