Akamai GTM Failover/Weighted Domain

akamai-gtm-failover

Akamai Global Traffic Management (GTM) failover / weighted domain in one module: a GTM domain, two or more data centers, and load-balancing properties (failover or weighted-round-robin) with a liveness health test so GTM detects a dead origin and steers traffic away. Works with Terraform and OpenTofu (>= 1.6), Akamai provider >= 10.0, < 11.0.

Status: static-validated, live-test pending. Ships under live-test quarantine — validated with tofu fmt, tofu validate, and tflint. Real apply → propagate → destroy against an Akamai GTM contract is pending a cloud sandbox. GTM domain names are globally unique and deletion is eventually-consistent, so destroys can take time on Akamai's side.

What you get:

• akamai_gtm_domain (defaults to type weighted).
• akamai_gtm_datacenter per entry in datacenters (min two — load balancing needs more than one target).
• akamai_gtm_property per entry in properties, with traffic_target blocks that reference data centers by your own key (decoupled from Akamai's generated datacenter IDs) and a shared liveness_test.

Secure / resilient defaults

• Health checks on by default: every property gets a liveness_test (HTTPS GET / every 60s, answers required), so GTM can fail over off an unhealthy data center. Set liveness_test = null only if you really want to disable it.
• load_feedback and cname_coalescing_enabled are on, so GTM routes around degraded origins and collapses CNAME chains.
• wait_on_complete = true by default — each apply returns only once GTM has propagated the change, so you never report success on an in-flight change.
• Preconditions enforce that every traffic target maps to a managed data center and that weighted properties carry weights — failures surface at plan time.

Provider pin

akamai = {
  source  = "akamai/akamai"
  version = ">= 10.0, < 11.0"
}

License

Commercial — LicenseRef-IaCBazaar-Commercial. © IaC Bazaar. Original work (not derived from a third-party module).