This module creates an ACM certificate and automatically validates it via DNS validation if a Route 53 zone id for a
public hosted zone managing the domain(s) DNS is provided.
If a Route 53 zone id is not provided, or if EMAIL
is the chosen validation method, this module provides no added
functionality beyond creating the ACM certificate as the aws_acm_certificate
Terraform resource normally would. If
that is the case, we recommend using the aws_acm_certificate
resource directly. Nevertheless, this module supports
either use case in order to facilitate a future migration to Route 53 if desired.
module "acm" {
source = "[email protected]:rackspace-infrastructure-automation/aws-terraform-acm//?ref=v0.12.3"
environment = "Production"
fqdn_list = ["example.com"]
tags = {
hello = "world"
}
}
Full working references are available at examples
The following module variables changes have occurred:
custom_tags
- marked for deprecation as it no longer meets our standards.
tags
- introduced as a replacement forcustom_tags
to better align with our standards.
Name | Version |
---|---|
aws | >= 2.7.0 |
tls | >= 2.0 |
Name | Description | Type | Default | Required |
---|---|---|---|---|
custom_tags | Optional tags to be applied on top of the base tags on all resources. [Deprecated in favor of tags ]. It will be removed in future releases. |
map(string) |
{} |
no |
environment | Application environment for which this network is being created. e.g. Development/Production | string |
"Development" |
no |
fqdn_list | A list FQDNs for which the certificate should be issued. | list(string) |
[] |
no |
fqdn_to_r53zone_map | A map of alternate Route 53 zone ids and corresponding FQDNs to validate. The key for each pair is the FQDN in which a certficate must be generated. This map will typically contain all of the FQDNS provided in fqdn_list. | map(string) |
{} |
no |
fqdn_to_r53zone_map_count | Provide the count of key/value pairs provided in variable fqdn_to_r53zone_map | string |
0 |
no |
self_signed | Boolean value indicating if a certificate should be self-signed. | bool |
false |
no |
tags | Optional tags to be applied on top of the base tags on all resources | map(string) |
{} |
no |
validation_creation_timeout | aws_acm_certificate_validation resource creation timeout. | string |
"45m" |
no |
validation_method | Which method to use for validation. DNS or EMAIL are valid, NONE can be used for certificates that were imported into ACM and then into Terraform. |
string |
"DNS" |
no |
Name | Description |
---|---|
arn | The ARN of the certificate |
domain_name | The domain name for which the certificate is issued |
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. |
id | The ARN of the certificate |
validation_emails | A list of addresses that received a validation E-Mail. Only set if EMAIL -validation was used. |