This module is basically combination of Terraform open source and includes automatation tests and examples. It also helps to create and improve your infrastructure with minimalistic code instead of maintaining the whole infrastructure code yourself.
To use this module, you can include it in your Terraform configuration. Here's an example of how to use it:
module "acm" {
source = "git::https://github.com/opsstation/terraform-aws-acm.git?ref=v1.0.0"
name = "certificate"
environment = "test"
domain_name = "opsstation.com"
subject_alternative_names = ["*.${local.domain}", "www.${local.domain}"]
}module "acm" {
source = "git::https://github.com/opsstation/terraform-aws-acm.git?ref=v1.0.0"
name = "certificate"
environment = "test"
validate_certificate = false
domain_name = "opsstation.com"
subject_alternative_names = ["www.opsstation.com"]
validation_method = "EMAIL"
}module "acm" {
source = "git::https://github.com/opsstation/terraform-aws-acm.git?ref=v1.0.0"
name = "certificate"
environment = "test"
import_certificate = true
private_key = "./../../../opsstation-private-key.pem"
certificate_body = "./../../../opsstation-cert.pem"
certificate_chain = "./../../../opsstation-chain.crt"
}For detailed examples on how to use this module, please refer to the example directory within this repository.
Your Name Replace '[License Name]' and '[Your Name]' with the appropriate license and your information. Feel free to expand this README with additional details or usage instructions as needed for your specific use case.
This project is licensed under the MIT License - see the LICENSE file for details.
| Name | Version |
|---|---|
| terraform | >= 1.5.4 |
| aws | >= 5.10 |
| Name | Version |
|---|---|
| aws | >= 5.10 |
| Name | Source | Version |
|---|---|---|
| labels | git::git@github.com:opsstation/terraform-aws-labels.git | v1.0.0 |
| Name | Type |
|---|---|
| aws_acm_certificate.cert | resource |
| aws_acm_certificate.import-cert | 8385resource |
| aws_acm_certificate_validation.cert | resource |
| aws_acm_certificate_validation.default | resource |
| aws_route53_record.default | resource |
| aws_route53_zone.default | data source |
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| allow_overwrite | Whether to allow overwrite of Route53 records | bool |
true |
no |
| certificate_body | Path of certificate body. | string |
"~" |
no |
| certificate_chain | Path of certificate chain. | string |
"" |
no |
| domain_name | A domain name for which the certificate should be issued. | string |
"" |
no |
| enable | Whether or not to enable the entire module or not. | bool |
true |
no |
| enable_aws_certificate | Set to false to prevent the creation of a acm certificate. | bool |
true |
no |
| enable_dns_validation | Set to prevent validation of DNS. | bool |
false |
no |
| environment | Environment (e.g. prod, dev, staging). |
string |
"" |
no |
| import_certificate | Set to true or false to decide the creation and import of a acm certificate. | bool |
false |
no |
| label_order | Label order, e.g. name,application. |
list(any) |
[ |
no |
| managedby | ManagedBy, eg 'opsstation' | string |
"" |
no |
| name | Name (e.g. app or cluster). |
string |
"" |
no |
| private_key | Path of private key. | string |
"" |
no |
| private_zone | Used with name field to get a private Hosted Zone. | bool |
false |
no |
| repository | Terraform current module repo | string |
"" |
no |
| 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 |
| ttl | Time to live. | number |
600 |
no |
| validate_certificate | Set to false to prevent the validation of a acm certificate. | bool |
false |
no |
| validation_method | Which method to use for validation, DNS or EMAIL. | string |
"DNS" |
no |
| 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 |
| 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 |
| Name | Description |
|---|---|
| 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. |
| acm_certificate_status | Status of the certificate. |
| arn | The ARN of the Certificate. |
| id | The ID of the Certificate. |
| tags | A mapping of tags to assign to the resource. |
| validation_route53_record_fqdns | List of FQDNs built using the zone domain and name. |