diff --git a/README.md b/README.md index 3b09c37..0d1af1c 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,14 @@ # Overbuilt myip module -## What it does: +## What it does This module polls a series of fairly well known but occasionally unreliable 'what is my ip' services. It then produces the most common response that is a valid ipv4 or ipv6 address (both outputs are separately provided). -We support two providers - `curl` and `http`. `curl` is the default provider because it has better failure handling whereas `http` provider will fail a plan/apply if the endpoint doesn't respond. +We support two providers - `curl2` and `http`. `curl2` is the default provider because it has better failure handling whereas `http` provider will fail a plan/apply if the endpoint doesn't respond. + +## Limitations + +Neither the `curl2` nor `http` providers are perfect. The `curl2` provider is slightly more reliable than the `http` provider. We should ideally check DNS prior to polling, or find a provider that won't poll unless dns resolves - or won't fail if it doesn't resolve. ## Requirements @@ -12,14 +16,14 @@ We support two providers - `curl` and `http`. `curl` is the default provider bec | Name | Version | |------|---------| | [terraform](#requirement\_terraform) | ~> 1.0 | -| [curl](#requirement\_curl) | ~> 1.0.2 | +| [curl2](#requirement\_curl2) | ~> 1.6 | | [http](#requirement\_http) | ~> 3 | ## Providers | Name | Version | |------|---------| -| [curl](#provider\_curl) | 1.0.2 | +| [curl2](#provider\_curl2) | 1.6.1 | | [http](#provider\_http) | 3.4.0 | ## Modules @@ -30,23 +34,41 @@ No modules. | Name | Type | |------|------| -| [curl_curl.myip](https://registry.terraform.io/providers/anschoewe/curl/latest/docs/data-sources/curl) | data source | +| [curl2_curl2.myip](https://registry.terraform.io/providers/mehulgohil/curl2/latest/docs/data-sources/curl2) | data source | | [http_http.myip](https://registry.terraform.io/providers/hashicorp/http/latest/docs/data-sources/http) | data source | ## Inputs | Name | Description | Type | Default | Required | |------|-------------|------|---------|:--------:| -| [data\_provider](#input\_data\_provider) | `curl` or `http` providers are both supported - we recommend `curl` | `string` | `"curl"` | no | +| [data\_provider](#input\_data\_provider) | `curl2` or `http` providers are both supported - we recommend `curl2` | `string` | `"curl2"` | no | | [extra\_service\_urls](#input\_extra\_service\_urls) | Put your own in here if you want extra ones, this gets merged with the `service_urls` list | `list(string)` | `[]` | no | -| [service\_urls](#input\_service\_urls) | List of urls to use for getting our IP | `list(string)` |
[| no | +| [request\_timeout](#input\_request\_timeout) | Request timeout in milliseconds | `number` | `500` | no | +| [retry\_attempts](#input\_retry\_attempts) | Request retries | `number` | `0` | no | +| [service\_urls](#input\_service\_urls) | List of urls to use for getting our IP | `list(string)` |
"https://api.seeip.org",
"https://ipinfo.io/ip",
"https://ifconfig.co",
"https://icanhazip.com",
"https://api.ipify.org",
"https://ifconfig.me",
"https://ipecho.net/plain",
"https://ifconfig.io",
"http://eth0.me/",
"https://ident.me",
"https://ipv4.ident.me"
]
[| no | ## Outputs | Name | Description | |------|-------------| -| [ipv4](#output\_ipv4) | n/a | -| [ipv4\_all\_matches](#output\_ipv4\_all\_matches) | n/a | -| [ipv6](#output\_ipv6) | n/a | -| [ipv6\_all\_matches](#output\_ipv6\_all\_matches) | n/a | +| [ipv4](#output\_ipv4) | The most common ipv4 response | +| [ipv4\_all\_matches](#output\_ipv4\_all\_matches) | List of all the ipv4 matches (informational/testing) | +| [ipv6](#output\_ipv6) | The most common ipv6 response | +| [ipv6\_all\_matches](#output\_ipv6\_all\_matches) | List of all the ipv6 matches (informational/testing) | + +## Authors + +Alex Trull (firstname@lastname.org) + +## License + +BSD-3 + +## Inspiration + +The failed builds because the myip service I had chosen wasn't working or there was a routing error in the pipeline. I owe it all to you! + +## Additional information for users from all ip addresses + +* I am very fond of you all. \ No newline at end of file diff --git a/main.tf b/main.tf index 53ac921..1812c69 100644 --- a/main.tf +++ b/main.tf @@ -1,9 +1,9 @@ terraform { required_version = "~> 1.0" required_providers { - curl = { - version = "~> 1.0.2" - source = "anschoewe/curl" + curl2 = { + version = "~> 1.6" + source = "mehulgohil/curl2" } http = { version = "~> 3" @@ -12,11 +12,18 @@ terraform { } } -# curl is the default method -data "curl" "myip" { - for_each = var.data_provider == "curl" ? toset(local.service_urls) : [] - http_method = "GET" +provider "curl2" { + timeout_ms = var.request_timeout + retry { + retry_attempts = var.retry_attempts + } +} + +# curl2 is the default method +data "curl2" "myip" { + for_each = var.data_provider == "curl2" ? toset(local.service_urls) : [] uri = each.key + http_method = "GET" } # but we can use http if you prefer @@ -24,7 +31,10 @@ data "http" "myip" { for_each = var.data_provider == "http" ? toset(local.service_urls) : [] url = each.key method = "GET" - request_timeout_ms = 500 + request_timeout_ms = var.request_timeout + retry { + attempts = var.retry_attempts + } } locals { @@ -32,7 +42,7 @@ locals { service_urls = distinct(concat(var.service_urls, var.extra_service_urls)) # build a list of responses - service_response_bodies = var.data_provider == "curl" ? values(data.curl.myip)[*].response : values(data.http.myip)[*].response_body + service_response_bodies = var.data_provider == "curl2" ? values(data.curl2.myip)[*].response.body : values(data.http.myip)[*].response_body # remunge it without whitespace as a list of strings split_output = split(",", replace(trimspace(join(",", local.service_response_bodies)), "/\\s/", "")) diff --git a/outputs.tf b/outputs.tf index 81c3ce6..aff2c4d 100644 --- a/outputs.tf +++ b/outputs.tf @@ -1,16 +1,19 @@ - -output "ipv4_all_matches" { - value = local.ipv4_matches +output "ipv4" { + value = join("", local.ipv4_most_common_response) + description = "The most common ipv4 response" } -output "ipv6_all_matches" { - value = local.ipv6_matches +output "ipv6" { + value = join("", local.ipv6_most_common_response) + description = "The most common ipv6 response" } -output "ipv4" { - value = join("", local.ipv4_most_common_response) +output "ipv4_all_matches" { + value = local.ipv4_matches + description = "List of all the ipv4 matches (informational/testing)" } -output "ipv6" { - value = join("", local.ipv6_most_common_response) -} \ No newline at end of file +output "ipv6_all_matches" { + value = local.ipv6_matches + description = "List of all the ipv6 matches (informational/testing)" +} diff --git a/variables.tf b/variables.tf index 0891cd6..40e7688 100644 --- a/variables.tf +++ b/variables.tf @@ -21,8 +21,20 @@ variable "extra_service_urls" { description = "Put your own in here if you want extra ones, this gets merged with the `service_urls` list" } +variable "request_timeout" { + default = 500 + type = number + description = "Request timeout in milliseconds" +} + +variable "retry_attempts" { + default = 1 + type = number + description = "Request retries" +} + variable "data_provider" { - default = "curl" + default = "curl2" type = string - description = "`curl` or `http` providers are both supported - we recommend `curl`" + description = "`curl2` or `http` providers are both supported - we recommend `curl2`" } \ No newline at end of file
"https://api.seeip.org",
"https://ipinfo.io/ip",
"https://ifconfig.co",
"https://icanhazip.com",
"https://api.ipify.org",
"https://ifconfig.me",
"https://ipecho.net/plain",
"https://ifconfig.io",
"https://ident.me",
"https://ipv4.ident.me"
]