Skip to content
This repository has been archived by the owner on Jan 5, 2020. It is now read-only.

Latest commit

 

History

History
82 lines (55 loc) · 3.04 KB

README.md

File metadata and controls

82 lines (55 loc) · 3.04 KB

aws

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with aws

Overview

Bootstrap utilities for EC2 and CloudFormation. A set of helper classes, functions and facts to aid in creating userdata and cfn-init scripts.

Module Description

There's a number of common actions that any boot script needs to do when booting an EC2 instance on Amazon Web Services, and a myriad of ways to customize the resulting instance.

This module seeks to standardize on Puppet and Ruby to reduce the complexity of the CloudFormation templates and/or userdata scripts, while using the same language/platform for initialization as provisioning and configuration.

What aws affects

Setup

  • Configures a wide number of different default settings for an instance
  • Runs privileged AWS API commands via custom functions executed on the Puppetmaster

Setup Requirements

Each instance that uses this package will need read access to various aspects of the AWS environment.

Use of the custom functions require that the Puppetmaster is configured with the appropriate level of access to create, attach, describe, etc.

It's assumed an instance profile will be configured on each machine, conversely the AWS Ruby API provides for use of the usual environment variables.