Giter VIP home page Giter VIP logo

terraform-aws-iam-role's Introduction

Terraform AWS IAM Role

Terraform module to create Iam role resource on AWS.

Terraform Licence tfsec static-checks


We eat, drink, sleep and most importantly love DevOps. We are working towards strategies for standardizing architecture while ensuring security for the infrastructure. We are strong believer of the philosophy Bigger problems are always solved by breaking them into smaller manageable problems. Resonating with microservices architecture, it is considered best-practice to run database, cluster, storage in smaller connected yet manageable pieces within the infrastructure.

This module is basically combination of Terraform open source and includes automatation tests and examples. It also helps to create and improve your infrastructure with minimalistic code instead of maintaining the whole infrastructure code yourself.

We have fifty plus terraform modules. A few of them are comepleted and are available for open source usage while a few others are in progress.

Prerequisites

This module has a few dependencies:

Examples

IMPORTANT: Since the master branch used in source varies based on new modifications, we suggest that you use the release versions here.

Simple example

Here is an example of how you can use this module in your inventory structure:

      module "iam-role" {
      source              = "clouddrove/iam-role/aws"
      version             = "1.3.0"

      name                = "iam-role"
      application         = "clouddrove"
      environment         = "test"
      label_order         = ["environment", "name"]
      assume_role_policy  = data.aws_iam_policy_document.default.json
      managed_policy_arns = 
      policy_enabled      = true
      policy              = data.aws_iam_policy_document.iam-policy.json
    }

      data "aws_iam_policy_document" "default" {
      statement {
      effect  = "Allow"
      actions = ["sts:AssumeRole"]
      principals {
      type        = "Service"
      identifiers = ["ec2.amazonaws.com"]
      }
      }
    }

      data "aws_iam_policy_document" "iam-policy" {
      statement {
      actions = [
      "ssm:UpdateInstanceInformation",
      "ssmmessages:CreateControlChannel",
      "ssmmessages:CreateDataChannel",
      "ssmmessages:OpenControlChannel",
      "ssmmessages:OpenDataChannel"    ]
      effect    = "Allow"
      resources = ["*"]
      }
    }

Inputs

Name Description Type Default Required
assume_role_policy Whether to create Iam role. any n/a yes
description The description of the role. string "" no
enabled Whether to create Iam role. bool true no
environment Environment (e.g. prod, dev, staging). string "" no
force_detach_policies The policy that grants an entity permission to assume the role. bool false no
label_order Label order, e.g. name,application. list(any)
[
"name",
"environment"
]
no
managed_policy_arns Set of exclusive IAM managed policy ARNs to attach to the IAM role list(any) [] no
managedby ManagedBy, eg 'CloudDrove' string "[email protected]" no
max_session_duration The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours. number 3600 no
name Name (e.g. app or cluster). string "" no
path The path to the role. string "/" no
permissions_boundary The ARN of the policy that is used to set the permissions boundary for the role. string "" no
policy The policy document. any null no
policy_arn The ARN of the policy you want to apply. string "" no
policy_enabled Whether to Attach Iam policy with role. bool false no
repository https://github.com/clouddrove/terraform-aws-iam-role string "" no

Outputs

Name Description
arn The Amazon Resource Name (ARN) specifying the role.
name Name of specifying the role.
policy The policy document attached to the role.
role The name of the role associated with the policy.
tags A mapping of tags to assign to the resource.

Testing

In this module testing is performed with terratest and it creates a small piece of infrastructure, matches the output like ARN, ID and Tags name etc and destroy infrastructure in your AWS account. This testing is written in GO, so you need a GO environment in your system.

You need to run the following command in the testing folder:

  go test -run Test

Feedback

If you come accross a bug or have any feedback, please log it in our issue tracker, or feel free to drop us an email at [email protected].

If you have found it worth your time, go ahead and give us a ★ on our GitHub!

About us

At CloudDrove, we offer expert guidance, implementation support and services to help organisations accelerate their journey to the cloud. Our services include docker and container orchestration, cloud migration and adoption, infrastructure automation, application modernisation and remediation, and performance engineering.

We are The Cloud Experts!


We ❤️ Open Source and you can check out our other modules to get help with your new Cloud ideas.

terraform-aws-iam-role's People

Contributors

yadavprakash avatar dhyanio avatar theprashantyadav avatar anmolnagpal avatar clouddrove-ci avatar davidjameshowell avatar bobbysinghh avatar vibutigoyal avatar 13archit avatar harmanjyotkaur avatar themaniskshah avatar tanveer143s avatar mamrajyadav avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.