Features: Core IAM module, X-ray submodule

[ryan-roemer]

Overview

This (massive) PR is intended to be the initial release of:

• The core IAM module to support a serverless framework application
• An optional X-Ray submodule to add IAM permissions needed for serverless X-ray support.

The companion reference application PR to review is: https://github.com/FormidableLabs/aws-lambda-serverless-reference/pull/7

Things I'd suggest to review (if all the files are too beastly):

• Core README: https://github.com/FormidableLabs/terraform-aws-serverless/blob/feature/xray/README.md
• X-ray README: https://github.com/FormidableLabs/terraform-aws-serverless/blob/feature/xray/modules/xray/README.md
• The variables (and all the ARNs to limit gathered in one place): https://github.com/FormidableLabs/terraform-aws-serverless/blob/feature/xray/variables.tf

Sample Integration

Basic, simplest integration is like this:

# Base `serverless` IAM support.
module "serverless" {
  source = "FormidableLabs/serverless/aws"

  region       = "${var.region}"
  service_name = "${var.service_name}"
  stage        = "${var.stage}"
}

# OPTION(Xray): Add X-ray support to lambda execution roles.
# **NOTE**: No explicit dependency on core, but it **is** needed.
module "serverless_xray" {
  source = "FormidableLabs/serverless/aws//modules/xray"

  region       = "${var.region}"
  service_name = "${var.service_name}"
  stage        = "${var.stage}"
}

Work

Completed:

• Add CONTRIBUTING.md document. Fixes #20
• Per-module/submodule READMEs. Fixes #17
• Root README.md. Fixes #16
• Rename project. Fixes #14
• CI: Set up. Fixes #7
• Feature: Stack / resource naming. Fixes #4
• Feature: Roles / Groups for admin, developer, CI enhancement. Fixes #2
• Feature/Option: Xray enhancement. Fixes #9

In progress:

• Review/remove all source TODOs. #15
• Publish: Terraform Registry. #5

/cc @tptee @jasonwilson @kevinmstephens @mscottx88 @jjasonclark @ianwsperber

[ryan-roemer]

I'm merging so I can figure out how to publish, etc., but post-merge review most welcome!