Terraform module for Nginx Ingress Controller

Terraform module used to create nginx ingress controller in Kubernetes via Helm. With simple syntax.

Usage

IngressClass

By default, all new ingresses use this controller as default.

If you have already default IngressClass specified, please set ingress_class_is_default=false.
In this case you should specify ingressClassName to your ingress manually.

AWS

module "nginx-controller" {
  source  = "terraform-iaac/nginx-controller/helm"

  additional_set = [
    {
      name  = "controller.service.annotations.service\\.beta\\.kubernetes\\.io/aws-load-balancer-type"
      value = "nlb"
      type  = "string"
    },
    {
      name  = "controller.service.annotations.service\\.beta\\.kubernetes\\.io/aws-load-balancer-cross-zone-load-balancing-enabled"
      value = "true"
      type  = "string"
    }
  ]
}

GCP

# Static IP
resource "google_compute_address" "ingress_ip_address" {
  name = "nginx-controller"
}

module "nginx-controller" {
  source  = "terraform-iaac/nginx-controller/helm"

  # Optional
  ip_address = google_compute_address.ingress_ip_address.address
}

AZURE

# Static IP
resource "azurerm_public_ip" "nginx_controller" {
  resource_group_name = "my-resource-group-name"
  location            = "my-location"

  name              = "nginx-controller"
  allocation_method = "Static"
}

module "nginx-controller" {
  source  = "terraform-iaac/nginx-controller/helm"

  ip_address = azurerm_public_ip.nginx_controller.ip_address
}

Inputs

Name	Description	Type	Default	Required
name	Name of created helm release	string	ingress-nginx	no
namespace	Name of namespace where nginx controller should be deployed	string	kube-system	no
chart_version	HELM Chart Version for controller ( It is not recommended to change )	string	4.0.6	no
atomic	If set, installation process purges chart on fail	bool	false	no
ingress_class_name	IngressClass resource name	string	nginx	no
ingress_class_is_default	IngressClass resource default for cluster	bool	true	no
ip_address	External Static Address for loadbalancer (Doesn't work with AWS)	string	n/a	no
controller_kind	Controller type: DaemonSet, Deployment etc..	string	DaemonSet	no
controller_daemonset_useHostPort	Also use host ports(80,443) for pods. Node Ports in services will be untouched	bool	false	no
controller_service_externalTrafficPolicy	Traffic policy for controller. See docs.	string	Local	no
controller_request_memory	Memory request for pod. Value in MB	nubmer	140	no
publish_service	Publish LoadBalancer endpoint to Service	bool	true	no
define_nodePorts	By default service using NodePorts. It can be generated automatically, or you can assign this ports number	bool	true	no
service_nodePort_http	NodePort number for http	number	32001	no
service_nodePort_https	NodePort number for https	number	32002	no
metrics_enabled	Allow exposing metrics for prometheus-operator	bool	false	no
disable_heavyweight_metrics	Disable some 'heavyweight' or unnecessary metrics	bool	false	no
additional_set	Additional sets to Helm	list(object({ name = string value = string type = string // Optional }))	[]	no
additional_set_list	Additional sets to Helm via set_list	list(object({ name = string value = list }))	[]	no
wait	Will wait until all resources are in a ready state"	bool	true	no
timeout	Time in seconds to wait for any individual kubernetes operation	number	300	no

Outputs

Name	Description
name	Namespace used by nginx controller
namespace	Namespace used by nginx controller
ingress_class_name	IngressClass name for this controller

Terraform Requirements

Name	Version
terraform	>= 1.3.0
helm	>= 2.10.0

Kubernetes version: >=1.19