README.md

AWS Certificate Module

This repo contains a Module to create AWS certificates and validate them using route53 with terraform.

This module allows you to create SSL certificates without interaction, 100% with terraform.

This module can be used to create wildcard certificates, certificates with multiples subdomains but won't work with certificates with different domains. Ex:

• OK -> jpamies.com, *.jpamies.com
• OK -> jpamies.com, staging.jpamies.com
• FAIL -> jpamies.com, .jordi.com

All the requested domains should be managed by the same Route53 zone.

Requirements

• Terraform version >= 0.12.20
• Terraform AWS Provider version 4.X (if you need to stay in 2.X pleas check the module version https://github.com/jpamies/terraform-aws-certificate/releases/tag/1.0.2)

How to use this Module

module "certificate" {
  source                    = "jpamies/certificate/aws"
  version                   = "~>1.0"
  domain_name               = var.domain
  subject_alternative_names = var.alternate_domains
  dns_zone_id               = var.domain_zone_id
  tags                      = var.tags
}

Check examples to view a detailed working example.

Terraform < 0.12 compatibility

To keep using latest stable version compatible with terraform < 0.12, https://github.com/jpamies/terraform-aws-certificate/releases/tag/0.0.5. Using ~>0.0 as version you'll get all the hotfixes for old syntax.

module "certificate" {
  source                    = "jpamies/certificate/aws"
  version                   = "~>0.1"
  domain_name               = var.domain
  subject_alternative_names = var.alternate_domains
  dns_zone_id               = var.domain_zone_id
  tags                      = var.tags
}

How is structured this module

This Module has the following folder structure:

• root: This folder contains the terraform module.
• main.tf: This file creates all the resources needed for the module.
• outputs.tf: This file contains the result of running the module.
• variables.tf: This folder contains all the variables needed to run the terraform, optionals and mandatory.
• examples: This folder contains examples of how to use the modules.
• test: Automated tests for the modules and examples.

How is this Module versioned?

This Module follows the principles of Semantic Versioning. You can find each new release, along with the changelog, in the Releases Page.

How do I contribute to this Module?

Everything related with terraform module structure, we try to follow @gruntwork-io style. Check https://www.gruntwork.io/ or @brikis98 's book for advanced terraform. Check out the Contribution Guidelines for instructions.

License

This code is released under the Apache 2.0 License. Please check LICENSE.