StatCan / terraform-kubernetes-cert-manager-certificate

Terraform module for a Cert Manager Issuer

Terraform Kubernetes Cert-Manager Certificate

Introduction

This module allows for the deployment of a cert-manager certificate.

Required Modules

• Certificate CRD from cert-manager.io/v1

Requirements

Name	Version
terraform	>= 0.13
helm	>= 2.0.0

Inputs

Name	Description	Type	Default	Required
dns_names	the dns hostnames for which to generate certificates for	list(string)	n/a	yes
issuer	the name and kind of the issuer to be used for issuing certificates for resources. Valid Kinds are: Issuer or ClusterIssuer	object({ name = string kind = string })	n/a	yes
name	the name for the Certificate custom resource	string	n/a	yes
namespace	the namespace where the resources should be deployed	string	n/a	yes
labels	the metadata labels to apply to created Certificate resources	map(string)	{}	no

Usage

module "certificate" {
  source = "git::https://gitlab.k8s.cloud.statcan.ca/cloudnative/terraform/modules/terraform-kubernetes-cert-manager-certificate.git?ref=v1.1.0"

  name = var.name
  namespace = "cert-manager-system"

  dns_names = [
    abc.example.com,
    efg.example.com,
  ]

  issuer = {
    name = var.cluster_issuer_name
    kind = var.cluster_issuer_kind
  }

  ...
}

Outputs

Name	Description
name	the name of the cert-manager Certificate resource
namespace	the namespace the identity resides in
secret_name	the name of the secret to contain generated TLS certificates

History

Date	Release	Change
20201022	v1.0.0	Initial release.
20231101	v1.1.0	Clean up vars and outputs and introduce full tf docs.