No commit activity in last 3 years
No release in over 3 years
SparklePack to provide mappings for Official Amazon and Ubuntu AMIs by region
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

sparkle-pack-aws-amis

SparklePack for Offical Ubuntu and Amazon Linux AWS AMIs

Use Cases

This SparklePack provides mappings for official Ubuntu LTS and Amazon Linux AMIs in all regions. It is useful for scenarios where you need cross-region and/or cross-platform compatibility, and do not want to maintain a list of AMIs in your codebase. Pinning to an exact gem version will ensure that you always get the same AMI.

Instance type and virtualization can be tuned via optional config arguments, and the set of available operating systems can also be trimmed according to preference.

Note: Semantic Versioning

"Breaking changes" in the context of this pack are changes that affect the usage of the pack in your SparkleFormation codebase. Updated AMIs are not considered "breaking." Revisions may include updates to the AMI ID for existing platforms. Minor changes may include new platforms.

Usage

Add the pack to your Gemfile and .sfn:

Gemfile:

source 'https://rubygems.org'

gem 'sfn'
gem 'sparkle-pack-aws-amis'

.sfn:

Configuration.new do
  sparkle_pack [ 'sparkle-pack-aws-amis' ]
  ...
end

In a SparkleFormation Template/Component/Dynamic:

registry!(:offical_amis, :name)

resources do
  ec2_instance do
  type 'AWS::EC2::Instance'
  properties do
    image_id map!(:official_amis, region!, 'trusty')
    ...
  end
end

The :official_amis registry accepts the following configuration options as additional arguments:

  • :type String: instance_store (default), ebs, ebs_io1, ebs_ssd. Amazon AMIs are not available for ebs or ebs_io1
  • :virt String: hvm (default) or pv
  • :os_versions Array: ['ubuntu_14', 'ubuntu_12', 'amazon_2015_09'] (default) or a subset.