ec2-facts

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

Usage no npm install needed!

<script type="module">
  import ec2Facts from 'https://cdn.skypack.dev/ec2-facts';
</script>

README

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