Add examples

Author: ringanta

examples/basic/README.md

@@ -17,9 +17,7 @@ Run `terraform destroy` to clean up them.
 
 ## Requirements
 
-| Name | Version |
-|------|---------|
-| aws | ~> 2.61 |
+No requirements.
 
 ## Providers
 

examples/basic/main.tf

@@ -1,26 +1,32 @@
 module "acm" {
-    source = "../../"
+  source = "../../"
 
-    domain_name = {
-        zone = "example.com"
-        domain = "example.com"
-    }
-    subject_alternative_names = [
-        {
-            zone = "example.com"
-            domain = "*.example.com"
-        },
-        {
-            zone = "example.org"
-            domain = "example.org"
-        },
-        {
-            zone =  "example.org"
-            domain = "*.example.org"
-        }
-    ]
+  providers = {
+    aws.route53 = aws
+    aws.acm     = aws
+  }
+
+  domain_name = {
+    zone   = "example.com"
+    domain = "example.com"
+  }
 
-    tags = {
-        Name = "ACM certificate with multiple hosted zones"
+  subject_alternative_names = [
+    {
+      zone   = "example.com"
+      domain = "*.example.com"
+    },
+    {
+      zone   = "example.org"
+      domain = "example.org"
+    },
+    {
+      zone   = "example.org"
+      domain = "*.example.org"
     }
-}
+  ]
+
+  tags = {
+    Name = "ACM certificate with multiple hosted zones"
+  }
+}

examples/basic/providers.tf

@@ -1,5 +1,3 @@
- provider "aws" {
-     version = "~> 2.61"
-     region = "us-west-2"
- }
- 
+provider "aws" {
+  region = "us-west-2"
+}

examples/different-aws-account/README.md

@@ -0,0 +1,36 @@
+# Terraform AWS ACM Multiple Hosted Zone Example
+
+This example provides guides on how to use terraform-aws-acm-multiple-hosted-zone module involving multiple AWS accounts.
+To be precise, the ACM certificate will be provisioned in a certain AWS account while the domain are hosted in another AWS account.
+
+## Usage 
+
+To run this example you need to execute:
+
+```terraform
+terraform init
+terraform plan -out=tfplan.out
+terraform apply tfplan.out
+```
+
+Note that this example may create resources that cost money.
+Run `terraform destroy` to clean up them.
+
+## Requirements
+
+No requirements.
+
+## Providers
+
+No provider.
+
+## Inputs
+
+No input.
+
+## Outputs
+
+| Name | Description |
+|------|-------------|
+| certificate\_arn | n/a |
+| certificate\_domains | n/a |

examples/different-aws-account/main.tf

@@ -0,0 +1,32 @@
+module "acm" {
+  source = "../../"
+
+  providers = {
+    aws.route53 = aws.production
+    aws.acm     = aws.staging
+  }
+
+  domain_name = {
+    zone   = "example.com"
+    domain = "example.com"
+  }
+
+  subject_alternative_names = [
+    {
+      zone   = "example.com"
+      domain = "*.example.com"
+    },
+    {
+      zone   = "example.org"
+      domain = "example.org"
+    },
+    {
+      zone   = "example.org"
+      domain = "*.example.org"
+    }
+  ]
+
+  tags = {
+    Name = "ACM certificate with multiple hosted zones and multiple AWS accounts"
+  }
+}

examples/different-aws-account/outputs.tf

@@ -0,0 +1,7 @@
+output "certificate_arn" {
+    value = module.acm.certificate_arn
+}
+
+output "certificate_domains" {
+    value = module.acm.certificate_domains
+}

examples/different-aws-account/providers.tf

@@ -0,0 +1,11 @@
+provider "aws" {
+  region  = "us-west-2"
+  profile = "production"
+  alias   = "production"
+}
+
+provider "aws" {
+  alias   = "staging"
+  region  = "us-west-2"
+  profile = "staging"
+}

examples/without-domain-validation/main.tf

@@ -1,28 +1,34 @@
 module "acm" {
-    source = "../../"
+  source = "../../"
 
-    domain_name = {
-        zone = "example.com"
-        domain = "example.com"
-    }
-    subject_alternative_names = [
-        {
-            zone = "example.com"
-            domain = "*.example.com"
-        },
-        {
-            zone = "example.org"
-            domain = "example.org"
-        },
-        {
-            zone =  "example.org"
-            domain = "*.example.org"
-        }
-    ]
+  providers = {
+    aws.acm     = aws
+    aws.route53 = aws
+  }
 
-    validation_set_records = false
+  domain_name = {
+    zone   = "example.com"
+    domain = "example.com"
+  }
 
-    tags = {
-        Name = "ACM request without setting validation records on Route53"
+  subject_alternative_names = [
+    {
+      zone   = "example.com"
+      domain = "*.example.com"
+    },
+    {
+      zone   = "example.org"
+      domain = "example.org"
+    },
+    {
+      zone   = "example.org"
+      domain = "*.example.org"
     }
-}
+  ]
+
+  validation_set_records = false
+
+  tags = {
+    Name = "ACM request without setting validation records on Route53"
+  }
+}

examples/without-domain-validation/providers.tf

@@ -1,4 +1,3 @@
- provider "aws" {
-     version = "~> 2.61"
-     region = "us-west-2"
- }
+provider "aws" {
+  region = "us-west-2"
+}