feat: Added wrappers for all modules (#40)

Author: antonbabenko

examples/log-group-with-log-stream/README.md

@@ -31,7 +31,9 @@ No providers.
 | Name | Source | Version |
 |------|--------|---------|
 | <a name="module_log_group"></a> [log\_group](#module\_log\_group) | ../../modules/log-group | n/a |
+| <a name="module_log_group_wrapped"></a> [log\_group\_wrapped](#module\_log\_group\_wrapped) | ../../wrappers/log-group | n/a |
 | <a name="module_log_stream"></a> [log\_stream](#module\_log\_stream) | ../../modules/log-stream | n/a |
+| <a name="module_log_stream_wrapped"></a> [log\_stream\_wrapped](#module\_log\_stream\_wrapped) | ../../wrappers/log-stream | n/a |
 
 ## Resources
 

examples/log-group-with-log-stream/main.tf

@@ -15,3 +15,39 @@ module "log_stream" {
   name           = "my-log-stream"
   log_group_name = module.log_group.cloudwatch_log_group_name
 }
+
+# Wrappers (e.g. useful when using with Terragrunt)
+module "log_group_wrapped" {
+  source = "../../wrappers/log-group"
+
+  items = {
+    "one" = {
+      name_prefix       = "my-log-group-wrapper1-"
+      retention_in_days = 7
+    }
+    "two" = {
+      name_prefix       = "my-log-group-wrapper2-"
+      retention_in_days = 14
+    }
+  }
+
+}
+
+module "log_stream_wrapped" {
+  source = "../../wrappers/log-stream"
+
+  items = {
+    "one1" = {
+      name           = "my-log-stream1-1"
+      log_group_name = module.log_group_wrapped.wrapper["one"].cloudwatch_log_group_name
+    }
+    "one2" = {
+      name           = "my-log-stream1-2"
+      log_group_name = module.log_group_wrapped.wrapper["one"].cloudwatch_log_group_name
+    }
+    "two" = {
+      name           = "my-log-stream2"
+      log_group_name = module.log_group_wrapped.wrapper["two"].cloudwatch_log_group_name
+    }
+  }
+}

wrappers/cis-alarms/README.md

@@ -0,0 +1,70 @@
+# Wrapper for module: `modules/cis-alarms`
+
+The configuration in this directory contains an implementation of a single module wrapper pattern, which allows managing several copies of a module in places where using the native Terraform 0.13+ `for_each` feature is not feasible (e.g., with Terragrunt).
+
+You may want to use a single Terragrunt configuration file to manage multiple resources without duplicating `terragrunt.hcl` files for each copy of the same module.
+
+This wrapper does not implement any extra functionality.
+
+## Usage with Terragrunt
+
+`terragrunt.hcl`:
+
+```hcl
+terraform {
+  source = "git::git@github.com:terraform-aws-modules/terraform-aws-cloudwatch.git?ref=master//wrappers/cis-alarms"
+}
+
+inputs = {
+  items = {
+    my-item = {
+      # omitted... can be any argument supported by the module
+    }
+    my-second-item = {
+      # omitted... can be any argument supported by the module
+    }
+    # omitted...
+  }
+}
+```
+
+## Usage with Terraform
+
+```hcl
+module "wrapper" {
+  source = "terraform-aws-modules/cloudwatch/aws//wrappers/cis-alarms"
+
+  items = {
+    my-item = {
+      # omitted... can be any argument supported by the module
+    }
+    my-second-item = {
+      # omitted... can be any argument supported by the module
+    }
+    # omitted...
+  }
+}
+```
+
+## Example: Manage multiple S3 buckets in one Terragrunt layer
+
+`eu-west-1/s3-buckets/terragrunt.hcl`:
+
+```hcl
+terraform {
+  source = "git::git@github.com:terraform-aws-modules/terraform-aws-s3-bucket.git?ref=master//wrappers"
+}
+
+inputs = {
+  items = {
+    bucket1 = {
+      bucket        = "my-random-bucket-1"
+      force_destroy = true
+    }
+    bucket2 = {
+      bucket        = "my-random-bucket-2"
+      force_destroy = true
+    }
+  }
+}
+```

wrappers/cis-alarms/main.tf

@@ -0,0 +1,15 @@
+module "wrapper" {
+  source = "../../modules/cis-alarms"
+
+  for_each = var.items
+
+  create                 = try(each.value.create, true)
+  use_random_name_prefix = try(each.value.use_random_name_prefix, false)
+  name_prefix            = try(each.value.name_prefix, "")
+  disabled_controls      = try(each.value.disabled_controls, [])
+  namespace              = try(each.value.namespace, "CISBenchmark")
+  log_group_name         = try(each.value.log_group_name, "")
+  alarm_actions          = try(each.value.alarm_actions, [])
+  actions_enabled        = try(each.value.actions_enabled, true)
+  tags                   = try(each.value.tags, {})
+}

wrappers/cis-alarms/outputs.tf

@@ -0,0 +1,4 @@
+output "wrapper" {
+  description = "Map of outputs of a wrapper."
+  value       = module.wrapper
+}

wrappers/cis-alarms/variables.tf

@@ -0,0 +1,5 @@
+variable "items" {
+  description = "Maps of items to create a wrapper from. Values are passed through to the module."
+  type        = any
+  default     = {}
+}

wrappers/cis-alarms/versions.tf

@@ -0,0 +1,3 @@
+terraform {
+  required_version = ">= 0.13.1"
+}

wrappers/log-group/README.md

@@ -0,0 +1,70 @@
+# Wrapper for module: `modules/log-group`
+
+The configuration in this directory contains an implementation of a single module wrapper pattern, which allows managing several copies of a module in places where using the native Terraform 0.13+ `for_each` feature is not feasible (e.g., with Terragrunt).
+
+You may want to use a single Terragrunt configuration file to manage multiple resources without duplicating `terragrunt.hcl` files for each copy of the same module.
+
+This wrapper does not implement any extra functionality.
+
+## Usage with Terragrunt
+
+`terragrunt.hcl`:
+
+```hcl
+terraform {
+  source = "git::git@github.com:terraform-aws-modules/terraform-aws-cloudwatch.git?ref=master//wrappers/log-group"
+}
+
+inputs = {
+  items = {
+    my-item = {
+      # omitted... can be any argument supported by the module
+    }
+    my-second-item = {
+      # omitted... can be any argument supported by the module
+    }
+    # omitted...
+  }
+}
+```
+
+## Usage with Terraform
+
+```hcl
+module "wrapper" {
+  source = "terraform-aws-modules/cloudwatch/aws//wrappers/log-group"
+
+  items = {
+    my-item = {
+      # omitted... can be any argument supported by the module
+    }
+    my-second-item = {
+      # omitted... can be any argument supported by the module
+    }
+    # omitted...
+  }
+}
+```
+
+## Example: Manage multiple S3 buckets in one Terragrunt layer
+
+`eu-west-1/s3-buckets/terragrunt.hcl`:
+
+```hcl
+terraform {
+  source = "git::git@github.com:terraform-aws-modules/terraform-aws-s3-bucket.git?ref=master//wrappers"
+}
+
+inputs = {
+  items = {
+    bucket1 = {
+      bucket        = "my-random-bucket-1"
+      force_destroy = true
+    }
+    bucket2 = {
+      bucket        = "my-random-bucket-2"
+      force_destroy = true
+    }
+  }
+}
+```

wrappers/log-group/main.tf

@@ -0,0 +1,12 @@
+module "wrapper" {
+  source = "../../modules/log-group"
+
+  for_each = var.items
+
+  create            = try(each.value.create, true)
+  name              = try(each.value.name, null)
+  name_prefix       = try(each.value.name_prefix, null)
+  retention_in_days = try(each.value.retention_in_days, null)
+  kms_key_id        = try(each.value.kms_key_id, null)
+  tags              = try(each.value.tags, {})
+}

wrappers/log-group/outputs.tf

@@ -0,0 +1,4 @@
+output "wrapper" {
+  description = "Map of outputs of a wrapper."
+  value       = module.wrapper
+}