feat: Module use example for Terraform 1.11+

Author: pawelpesz

examples/simple-terraform-1-11/main.tf

@@ -0,0 +1,42 @@
+terraform {
+  required_version = ">= 0.15"
+
+  required_providers {
+    aws = {
+      source  = "hashicorp/aws"
+      version = ">= 4.0.0"
+    }
+  }
+}
+
+provider "aws" {
+  region = var.region
+}
+
+provider "aws" {
+  alias  = "replica"
+  region = var.replica_region
+}
+
+module "remote_state" {
+  source = "../../"
+
+  # Do not create the DynamoDB lock table
+  create_dynamodb_table = false
+  # Instead, add S3 lock file permissions to the IAM policy
+  terraform_iam_policy_add_lockfile_permissions = true
+
+  providers = {
+    aws         = aws
+    aws.replica = aws.replica
+  }
+}
+
+resource "aws_iam_user" "terraform" {
+  name = "TerraformUser"
+}
+
+resource "aws_iam_user_policy_attachment" "remote_state_access" {
+  user       = aws_iam_user.terraform.name
+  policy_arn = module.remote_state.terraform_iam_policy.arn
+}

examples/simple-terraform-1-11/outputs.tf

@@ -0,0 +1,9 @@
+output "kms_key" {
+  description = "The KMS customer master key to encrypt state buckets."
+  value       = module.remote_state.kms_key.key_id
+}
+
+output "state_bucket" {
+  description = "The S3 bucket to store the remote state file."
+  value       = module.remote_state.state_bucket.bucket
+}

examples/simple-terraform-1-11/variables.tf

@@ -0,0 +1,11 @@
+variable "region" {
+  description = "The AWS region in which resources are set up."
+  type        = string
+  default     = "us-east-1"
+}
+
+variable "replica_region" {
+  description = "The AWS region to which the state bucket is replicated."
+  type        = string
+  default     = "us-west-1"
+}