Repository files navigation

This is a collection of modules for external TCP/UDP load balancers. The root module is an implementation of passthrough regional TCP Load Balancer for GCE using target pool and forwarding rule. A regional proxy based external load balancer is implemented as a submodlue[modules/regional_proxy_lb/].

• TCP load balancer
• HTTP/S load balancer
• Internal load balancer

This module is meant for use with Terraform 0.13+ and tested using Terraform 1.0+. If you find incompatibilities using Terraform >=0.13, please open an issue.If you haven'tupgraded and need a Terraform0.12.x-compatible version of this module, the last released versionintended for Terraform 0.12.x isv2.3.0.

Basic usage is as follows:

module"load_balancer" {source="GoogleCloudPlatform/lb/google"version="~> 2.0.0"region=var.regionname="load-balancer"service_port=80target_tags=["allow-lb-service"]network=var.network}module"managed_instance_group" {source="terraform-google-modules/vm/google//modules/mig"version="~> 1.0.0"region=var.regiontarget_size=2hostname="mig-simple"instance_template=module.instance_template.self_linktarget_pools=[module.load_balancer.target_pool]named_ports=[{    name="http"    port=80  }]}

Full functional examples are located in theexamples directory.

Figure 1. Diagram of Terraform resources created by module (in green).

• google_compute_forwarding_rule.default: TCP Forwarding rule to the service port on the instances.
• google_compute_target_pool.default: The target pool created for the instance group.
• google_compute_http_health_check.default: The health check for the instance group targeted at the service port.
• google_compute_firewall.default-lb-fw: Firewall that allows traffic from anywhere to instances service port.

[
  "0.0.0.0/0"
]

object({
    check_interval_sec  = number
    healthy_threshold   = number
    timeout_sec         = number
    unhealthy_threshold = number
    port                = number
    request_path        = string
    host                = string
  })

{
  "check_interval_sec": null,
  "healthy_threshold": null,
  "host": null,
  "port": null,
  "request_path": null,
  "timeout_sec": null,
  "unhealthy_threshold": null
}

Thehealth_check variable values are passed on to thegoogle_compute_http_health_check resource. Setting values tonull will usegoogle_compute_http_health_checkdefaults. It takes the following parameters: