ec2-facts

NPM Package to save AWS EC2 Instance Metadata into a Puppet Custom Facts

Installation

$ sudo npm install -g ec2-facts

or

$ sudo npm install -g --ignore-scripts ec2-facts

Current Release

Alpha v0.0.6 is here! A lot of changes is on the way!

Configuration

ec2-facts searches and reads a JSON formatted file named ec2-facts.conf.json in /etc.

{
  "externalFactsFolder":"/some/folder"
}

Parameters

• externalFactsFolder - string Location of Facter's external facts e.g. /some/folder
• factNamePrefix - string Fact name prefix e.g. ec2-static-

Parameters (under development)

• exclude - array Metadata to exclude e.g. ['instance-type', 'mac']

Usage

# ec2-facts

Release Notes (Alpha Version)

1. Currently fetches the following metadata:

• ami-id
• ami-launch-index
• ami-manifest-path
• ancestor-ami-ids
• instance-id
• instance-type
• kernel-id
• local-hostname
• local-ipv4
• mac
• availability-zone
• product-codes
• public-hostname
• public-ipv4
• ramdisk-id
• reservation-id
• security-groups
• services-domain
• spot-termination-time
• more metadata on next release :)

1. Facts are saved in JSON format.
2. Default external facts folder is: /etc/facter/facts.d