{"id":19914725,"url":"https://github.com/fullstorydev/terraform-google-fullstory-cloud-relay","last_synced_at":"2026-03-19T12:25:49.630Z","repository":{"id":166969536,"uuid":"629688512","full_name":"fullstorydev/terraform-google-fullstory-cloud-relay","owner":"fullstorydev","description":"This module creates a relay that allows you to route all captured FullStory traffic from your users’ browser directly through your own domain. ","archived":false,"fork":false,"pushed_at":"2024-04-09T18:35:32.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-01T09:19:50.518Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.fullstory.com/","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fullstorydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-18T20:33:19.000Z","updated_at":"2023-05-18T18:10:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"0eb61e71-f58f-47bd-8253-b975ad915dd9","html_url":"https://github.com/fullstorydev/terraform-google-fullstory-cloud-relay","commit_stats":null,"previous_names":["fullstorydev/terraform-google-fullstory-cloud-relay"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/fullstorydev/terraform-google-fullstory-cloud-relay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Fterraform-google-fullstory-cloud-relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Fterraform-google-fullstory-cloud-relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Fterraform-google-fullstory-cloud-relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Fterraform-google-fullstory-cloud-relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fullstorydev","download_url":"https://codeload.github.com/fullstorydev/terraform-google-fullstory-cloud-relay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Fterraform-google-fullstory-cloud-relay/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262819232,"owners_count":23369438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T21:36:53.298Z","updated_at":"2026-02-02T13:40:00.368Z","avatar_url":"https://github.com/fullstorydev.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://fullstory.com\"\u003e\u003cimg src=\"https://github.com/fullstorydev/terraform-google-fullstory-cloud-relay/blob/main/assets/fs-logo.png?raw=true\"\u003e\u003c/a\u003e\n\n# terraform-google-fullstory-cloud-relay\n\n[![GitHub release](https://img.shields.io/github/release/fullstorydev/terraform-google-fullstory-cloud-relay.svg)](https://github.com/fullstorydev/terraform-google-fullstory-cloud-relay/releases/)\n\n\nThis module creates a relay that allows you to route all captured fullstory traffic\nfrom your users’ browser directly through your own domain. More information on the philosophy and \nscript configuration can be found in [this KB article](https://help.fullstory.com/hc/en-us/articles/360046112593-How-to-send-captured-traffic-to-your-First-Party-Domain-using-fullstory-Relay).\n\n\u003c!-- BEGIN_TF_DOCS --\u003e\n## Requirements\n\n| Name | Version |\n|------|---------|\n| \u003ca name=\"requirement_terraform\"\u003e\u003c/a\u003e [terraform](#requirement\\_terraform) | \u003e= 0.13 |\n| \u003ca name=\"requirement_google\"\u003e\u003c/a\u003e [google](#requirement\\_google) | \u003e= 4.32.0 |\n\n## Inputs\n\n| Name | Description | Type | Default | Required |\n|------|-------------|------|---------|:--------:|\n| \u003ca name=\"input_cloud_dns_project_id\"\u003e\u003c/a\u003e [cloud\\_dns\\_project\\_id](#input\\_cloud\\_dns\\_project\\_id) | (optional) The project in which the Cloud DNS zone lives in. Defaults to provider project. | `string` | `null` | no |\n| \u003ca name=\"input_cloud_dns_zone_name\"\u003e\u003c/a\u003e [cloud\\_dns\\_zone\\_name](#input\\_cloud\\_dns\\_zone\\_name) | (optional) The Cloud DNS zone name for placing the DNS A record. | `string` | `null` | no |\n| \u003ca name=\"input_logging_enabled\"\u003e\u003c/a\u003e [logging\\_enabled](#input\\_logging\\_enabled) | (optional) If enabled, logging will be active on the backend service. Defaults to false. | `bool` | `false` | no |\n| \u003ca name=\"input_relay_fqdn\"\u003e\u003c/a\u003e [relay\\_fqdn](#input\\_relay\\_fqdn) | The fully qualified domain name for the relay. Example: `fsrelay.your-company.com`. | `string` | n/a | yes |\n| \u003ca name=\"input_target_fqdn\"\u003e\u003c/a\u003e [target\\_fqdn](#input\\_target\\_fqdn) | (optional) The fully qualified domain name that the relay targets. Defaults to `fullstory.com`. | `string` | `\"fullstory.com\"` | no |\n\n## Outputs\n\n| Name | Description |\n|------|-------------|\n| \u003ca name=\"output_relay_ip_address\"\u003e\u003c/a\u003e [relay\\_ip\\_address](#output\\_relay\\_ip\\_address) | The IP address of the relay load balancer. |\n\n## Usage\n\n### With Cloud DNS Record Creation\n\n```hcl\nmodule \"fullstory_relay\" {\n  source               = \"fullstorydev/fullstory-cloud-relay/google\"\n  relay_fqdn           = \"fsrelay.your-company.com\"\n  cloud_dns_zone_name  = \"your-company-com\"\n  cloud_dns_project_id = \"gcp-your-company\"\n}\n```\n\n\u003e :warning: **Note:** SSL Certificates can take 10-15 minutes to become active after creation. Errors may be returned during this time.\n\n### Without Cloud DNS Record Creation\n\nBy default, the module will not create a DNS record in Cloud DNS. An example of which is below.\n\n```hcl\nmodule \"fullstory_relay\" {\n  source     = \"fullstorydev/fullstory-cloud-relay/google\"\n  relay_fqdn = \"fsrelay.your-company.com\"\n}\n\noutput \"relay_ip_address\" {\n  value = module.fullstory_relay.relay_ip_address\n}\n```\n\nOnce the resources have been successfully created, the IP address can be extracted from the Terraform state using the command below.\n\n```bash\nterraform output relay_ip_address\n```\n\nIf the above command does not work, ensure that the `output \"relay_ip_address\"` block is present as shown in the example above.\n\nNext, create an `A` DNS record that routes the `relay_fqdn` to the IP address found in the previous command.\n\nOnce the DNS record has been created, the SSL certificate can take up to 15 minutes to become active. The status can be checked using the command below.\n\n```bash\ngcloud compute ssl-certificates list\n```\n\n### European Realm Target\n\n```hcl\nmodule \"fullstory_relay\" {\n  source      = \"fullstorydev/fullstory-cloud-relay/google\"\n  relay_fqdn  = \"fsrelay.your-company.com\"\n  target_fqdn = \"eu1.fullstory.com\"\n}\n```\n\n### Validation\nOnce an instance of the fullstory Relay has been successfully created, the health endpoint at `https://\u003crelay_fqdn\u003e/healthz` should return a `200 OK`.\n\n## Resources\n\n| Name | Type |\n|------|------|\n| [google_compute_backend_service.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_backend_service) | resource |\n| [google_compute_global_address.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_global_address) | resource |\n| [google_compute_global_forwarding_rule.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_global_forwarding_rule) | resource |\n| [google_compute_global_network_endpoint.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_global_network_endpoint) | resource |\n| [google_compute_global_network_endpoint_group.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_global_network_endpoint_group) | resource |\n| [google_compute_managed_ssl_certificate.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_managed_ssl_certificate) | resource |\n| [google_compute_target_https_proxy.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_target_https_proxy) | resource |\n| [google_compute_url_map.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_url_map) | resource |\n| [google_dns_record_set.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/dns_record_set) | resource |\n| [google_dns_managed_zone.fullstory_relay](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/dns_managed_zone) | data source |\n\u003c!-- END_TF_DOCS --\u003e\n\n## Troubleshooting\n\nThis module includes a troubleshooting endpoint that can be used to debug any communications issues. The endpoint can be found out `https://\u003crelay_fqdn\u003e/echo` and returns the headers of the request.\n\n## Contributing\nSee [CONTRIBUTING.md](https://github.com/fullstorydev/terraform-google-fullstory-cloud-relay/blob/main/.github/CONTRIBUTING.md) for best practices and instructions on setting up your dev environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullstorydev%2Fterraform-google-fullstory-cloud-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffullstorydev%2Fterraform-google-fullstory-cloud-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullstorydev%2Fterraform-google-fullstory-cloud-relay/lists"}