acm-request-certificate

cloudposse/acm-request-certificate/aws

Terraform Module HCL AWS

Terraform module to request an ACM certificate for a domain name and create a CNAME record in the DNS zone to complete certificate validation

Install
module "acm-request-certificate" {
source = "cloudposse/acm-request-certificate/aws"
version = "0.18.1"
}
plain text: /constructs/tfmod-cloudposse-acm-request-certificate-aws/install.txt
⭐ Source on GitHub 📦 Registry page
README

Terraform module to request an ACM certificate for a domain and add a CNAME record to the DNS zone to complete certificate validation > [!TIP] > #### 👽 Use Atmos with Terraform > Cloud Posse uses atmos to easily orchestrate multiple environments using Terraform. > Works with Github Actions, Atlantis, or Spacelift. > > > Watch demo of using Atmos with Terraform > > Example of running atmos to manage infrastructure from our Quick Start tutorial. > Usage This example will request an SSL certificate for example.com domain ``hcl module "acm_request_certificate" { source = "cloudposse/acm-request-certificate/aws" # Cloud Posse recommends pinning every module to a specific version # version = "x.x.x" domain_name = "example.com" process_domain_validation_options = true ttl = "300" } ` This example

Inputs (30)
NameTypeDescriptionDefault
domain_namestringA domain name for which the certificate should be issued required
enabledboolSet to false to prevent the module from creating any resourcesnull
tenantstringID element _(Rarely used, not included by default)_. A customer identifier, indinull
environmentstringID element. Usually used for region e.g. 'uw2', 'us-west-2', OR role 'prod', 'stnull
stagestringID element. Usually used to indicate role, e.g. 'prod', 'staging', 'source', 'bunull
delimiterstringDelimiter to be used between ID elements. Defaults to `-` (hyphen). Set to `""` null
additional_tag_mapmap(string)Additional key-value pairs to add to each map in `tags_as_list_of_maps`. Not add{}
id_length_limitnumberLimit `id` to this many characters (minimum 6). Set to `0` for unlimited length.null
wait_for_certificate_issuedboolWhether to wait for the certificate to be issued by ACM (the certificate status false
tagsmap(string)Additional tags (e.g. `{'BusinessUnit': 'XYZ'}`). Neither the tag keys nor the t{}
validation_methodstringMethod to use for validation, DNS or EMAIL"DNS"
subject_alternative_nameslist(string)A list of domains that should be SANs in the issued certificate[]
zone_namestringThe name of the desired Route53 Hosted Zone""
certificate_authority_arnstringARN of an ACM PCAnull
key_algorithmstringSpecifies the algorithm of the public and private key pair that your Amazon issunull
label_orderlist(string)The order in which the labels (ID elements) appear in the `id`. Defaults to ["nanull
regex_replace_charsstringTerraform regular expression (regex) string. Characters matching the regex will null
ttlstringThe TTL of the record to add to the DNS zone to complete certificate validation"300"
zone_idstringThe zone id of the Route53 Hosted Zone which can be used instead of `var.zone_nanull
certificate_exportboolSpecifies whether the certificate can be exportedfalse
descriptor_formatsanyDescribe additional descriptors to be output in the `descriptors` output map. Ma{}
Outputs (5)
validation_id — The ID of the certificate validation
validation_certificate_arn — Certificate ARN from the `aws_acm_certificate_validation` resource
id — The ID of the certificate
arn — The ARN of the certificate
domain_validation_options — CNAME records that are added to the DNS zone to complete certificate validation
Resources (3)
aws_acm_certificateaws_acm_certificate_validationaws_route53_record
Details
FrameworkTerraform Module
LanguageHCL
Version0.18.1
Cloud AWS
★ Stars112
Forks71
Total downloads3.4M
Inputs30
Outputs5
Resources3
Examples1
LicenseApache-2.0
Namespacecloudposse
Updated