README.md

terraform-aws-iam-role

Terraform module to create AWS IAM Role. Currently supported type of Roles are:

1. Role for AWS Service
2. Role for IAM User
3. Role for External AWS Account
4. Role for Instance Profile
5. Role for Lambda

Usage

This module will only create an IAM Role and its Trust Relationships policy document. You need to attach your own Permission policy document outside the module.

To use a particular type of supported role, you can go into modules folder and read README.md at each subfolder for more detailed information.

To understand better on how to implement this module, you can go into examples folder and try them.

Modules

• AWS Service
• IAM User
• External AWS Account
• Instance Profile
• Lambda

Examples

• Service Role for Config
• IAM Role for User
• IAM Role for 3rd Party AWS Account
• IAM Role for Instance Profile
• IAM Role for Lambda

Tests

To run the test:

1. Install Ruby with version specified in the Gemfile.
2. Install bundler: gem install bundler
3. Install gems: bundle install
4. Run test from the root of the repository: bundle exec kitchen test

Terraform Version

This module was created using Terraform 0.11.4. So to be more safe, Terraform version 0.11.4 or newer is required to use this module.

AWS Provider Version

Minimum required version for AWS Provider is 1.14.0

Authors

• Rafi Kurnia Putra

License

Apache 2 Licensed. See LICENSE for full details.