Skip to content

Commit a9b8563

Browse files
committed
update README.md
1 parent 33919dd commit a9b8563

File tree

1 file changed

+47
-44
lines changed

1 file changed

+47
-44
lines changed

README.md

Lines changed: 47 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -13,17 +13,14 @@
1313

1414
<p align="center">
1515

16-
<a href="https://www.terraform.io">
17-
<img src="https://img.shields.io/badge/Terraform-v1.1.7-green" alt="Terraform">
18-
</a>
19-
<a href="LICENSE.md">
20-
<img src="https://img.shields.io/badge/License-APACHE-blue.svg" alt="Licence">
16+
<a href="https://github.com/clouddrove/terraform-aws-acm/releases/latest">
17+
<img src="https://img.shields.io/github/release/clouddrove/terraform-aws-acm.svg" alt="Latest Release">
2118
</a>
2219
<a href="https://github.com/clouddrove/terraform-aws-acm/actions/workflows/tfsec.yml">
2320
<img src="https://github.com/clouddrove/terraform-aws-acm/actions/workflows/tfsec.yml/badge.svg" alt="tfsec">
2421
</a>
25-
<a href="https://github.com/clouddrove/terraform-aws-acm/actions/workflows/terraform.yml">
26-
<img src="https://github.com/clouddrove/terraform-aws-acm/actions/workflows/terraform.yml/badge.svg" alt="static-checks">
22+
<a href="LICENSE.md">
23+
<img src="https://img.shields.io/badge/License-APACHE-blue.svg" alt="Licence">
2724
</a>
2825

2926

@@ -56,11 +53,7 @@ We have [*fifty plus terraform modules*][terraform_modules]. A few of them are c
5653
## Prerequisites
5754

5855
This module has a few dependencies:
59-
60-
- [Terraform 1.x.x](https://learn.hashicorp.com/terraform/getting-started/install.html)
61-
- [Go](https://golang.org/doc/install)
62-
- [github.com/stretchr/testify/assert](https://github.com/stretchr/testify)
63-
- [github.com/gruntwork-io/terratest/modules/terraform](https://github.com/gruntwork-io/terratest)
56+
- [Terraform 1.5.3](https://learn.hashicorp.com/terraform/getting-started/install.html)
6457

6558

6659

@@ -78,45 +71,50 @@ Here are some examples of how you can use this module in your inventory structur
7871
### ACM with DNS
7972
```hcl
8073
module "acm" {
81-
source = "clouddrove/acm/aws"
82-
version = "1.3.0"
83-
name = "certificate"
84-
environment = "test"
85-
label_order = ["name","environment"]
86-
domain_name = "clouddrove.com"
87-
validation_method = "DNS"
88-
enable_dns_validation = false
89-
enable_aws_certificate = true
74+
source = "clouddrove/acm/aws"
75+
version = "1.3.0"
76+
name = "certificate"
77+
environment = "test"
78+
label_order = ["name", "environment"]
79+
80+
enable_aws_certificate = true
81+
domain_name = "clouddrove.com"
82+
subject_alternative_names = ["www.clouddrove.com"]
83+
validation_method = "DNS"
84+
enable_dns_validation = false
9085
}
9186
```
9287

9388
### ACM with Email
9489
```hcl
9590
module "acm" {
96-
source = "clouddrove/acm/aws"
97-
version = "1.3.0"
98-
name = "certificate"
99-
environment = "test"
100-
label_order = ["name","environment"]
101-
domain_name = "clouddrove.com"
102-
validation_method = "EMAIL"
103-
validate_certificate = false
104-
enable_aws_certificate = true
91+
source = "clouddrove/acm/aws"
92+
version = "1.3.0"
93+
name = "certificate"
94+
environment = "test"
95+
label_order = ["name", "environment"]
96+
97+
validate_certificate = false
98+
domain_name = "clouddrove.com"
99+
subject_alternative_names = ["www.clouddrove.com"]
100+
validation_method = "EMAIL"
101+
enable_aws_certificate = true
105102
}
106103
```
107104

108105
### ACM with Import Certificate
109106
```hcl
110107
module "acm" {
111-
source = "clouddrove/acm/aws"
112-
version = "1.3.0"
113-
name = "certificate"
114-
environment = "test"
115-
label_order = ["name","environment"]
116-
private_key = "./../../../clouddrove-private-key.pem"
117-
certificate_body = "./../../../clouddrove-cert.pem"
118-
certificate_chain = "./../../../clouddrove-chain.crt"
119-
import_certificate = true
108+
source = "clouddrove/acm/aws"
109+
version = "1.3.0"
110+
name = "certificate"
111+
environment = "test"
112+
label_order = ["name", "environment"]
113+
114+
import_certificate = true
115+
private_key = "./../../../clouddrove-private-key.pem"
116+
certificate_body = "./../../../clouddrove-cert.pem"
117+
certificate_chain = "./../../../clouddrove-chain.crt"
120118
}
121119
```
122120

@@ -129,33 +127,38 @@ module "acm" {
129127

130128
| Name | Description | Type | Default | Required |
131129
|------|-------------|------|---------|:--------:|
132-
| attributes | Additional attributes (e.g. `1`). | `list(any)` | `[]` | no |
130+
| allow\_overwrite | Whether to allow overwrite of Route53 records | `bool` | `true` | no |
133131
| certificate\_body | Path of certificate body. | `string` | `"~"` | no |
134132
| certificate\_chain | Path of certificate chain. | `string` | `""` | no |
135133
| domain\_name | A domain name for which the certificate should be issued. | `string` | `""` | no |
136-
| enable\_acm\_certificate | Set to false to prevent the creation of a acm certificate. | `bool` | `true` | no |
137-
| enable\_aws\_certificate | Set to false to prevent the creation of a acm certificate. | `bool` | `false` | no |
134+
| enable | Whether or not to enable the entire module or not. | `bool` | `true` | no |
135+
| enable\_aws\_certificate | Set to false to prevent the creation of a acm certificate. | `bool` | `true` | no |
138136
| enable\_dns\_validation | Set to prevent validation of DNS. | `bool` | `false` | no |
139137
| environment | Environment (e.g. `prod`, `dev`, `staging`). | `string` | `""` | no |
140138
| import\_certificate | Set to true or false to decide the creation and import of a acm certificate. | `bool` | `false` | no |
141-
| label\_order | Label order, e.g. `name`,`application`. | `list(any)` | `[]` | no |
139+
| label\_order | Label order, e.g. `name`,`application`. | `list(any)` | <pre>[<br> "name",<br> "environment"<br>]</pre> | no |
142140
| managedby | ManagedBy, eg 'CloudDrove' | `string` | `"hello@clouddrove.com"` | no |
143141
| name | Name (e.g. `app` or `cluster`). | `string` | `""` | no |
144142
| private\_key | Path of private key. | `string` | `""` | no |
143+
| private\_zone | Used with name field to get a private Hosted Zone. | `bool` | `false` | no |
145144
| repository | Terraform current module repo | `string` | `"https://github.com/clouddrove/terraform-aws-acm"` | no |
146145
| subject\_alternative\_names | Set of domains that should be SANs in the issued certificate. To remove all elements of a previously configured list, set this value equal to an empty list ([]) or use the terraform taint command to trigger recreation. | `list(any)` | `[]` | no |
147-
| tags | Additional tags (e.g. map(`BusinessUnit`,`XYZ`). | `map(any)` | `{}` | no |
148146
| ttl | Time to live. | `number` | `600` | no |
149147
| validate\_certificate | Set to false to prevent the validation of a acm certificate. | `bool` | `false` | no |
150148
| validation\_method | Which method to use for validation, DNS or EMAIL. | `string` | `""` | no |
149+
| validation\_option | The domain name that you want ACM to use to send you validation emails. This domain name is the suffix of the email addresses that you want ACM to use. | `any` | `{}` | no |
150+
| validation\_record\_fqdns | When validation is set to DNS and the DNS validation records are set externally, provide the fqdns for the validation | `list(string)` | `[]` | no |
151151

152152
## Outputs
153153

154154
| Name | Description |
155155
|------|-------------|
156+
| acm\_certificate\_domain\_validation\_options | A list of attributes to feed into other resources to complete certificate validation. Can have more than one element, e.g. if SANs are defined. Only set if DNS-validation was used. |
157+
| acm\_certificate\_status | Status of the certificate. |
156158
| arn | The ARN of the Certificate. |
157159
| id | The ID of the Certificate. |
158160
| tags | A mapping of tags to assign to the resource. |
161+
| validation\_route53\_record\_fqdns | List of FQDNs built using the zone domain and name. |
159162

160163

161164

0 commit comments

Comments
 (0)