feat: add example

Author: Orkuncakilkaya

examples/main/README.md

@@ -0,0 +1,23 @@
+## Main example for Fingerprint Fastly VCL Proxy Integration
+
+This project is an example of how to create a Fastly VCL service for the [Fingerprint Fastly VCL proxy integration Terraform module](https://github.com/fingerprintjs/terraform-fastly-fingerprint-vcl-proxy-integration).
+Learn more in the [Fastly VCL Proxy Terraform installation guide](https://dev.fingerprint.com/docs/deploy-fastly-vcl-using-terraform).
+
+### Running the example
+
+To quickly run the example for testing purposes, you can:
+
+1. Copy the [terraform.tfvars.example](./terraform.tfvars.example) file into a new `terraform.tfvars` file and replace the values with your own. The variables are defined and described in the [variables.tf](./variables.tf) file.
+2. Copy your Fastly API token
+4. Run `terraform init`.
+5. Run `terraform apply -target=module.fingerprint_fastly_vcl_integration.module.compute_asset`
+7. Run `terraform plan`.
+8. Run `terraform apply`.
+
+### Using in production
+
+This is a simplified example. Use it as a reference but make sure to **adjust the code to your needs and security practices** before deploying it to production environments.
+
+### Additional resources
+
+- [Fingerprint Fastly VCL Proxy Integration documentation](https://dev.fingerprint.com/docs/fastly-vcl-proxy-integration)

examples/main/fingerprint.tf

@@ -0,0 +1,10 @@
+module "fingerprint_fastly_vcl_integration" {
+  source = "../.."
+  agent_script_download_path = var.agent_script_download_path
+  get_result_path = var.get_result_path
+  integration_domain = var.integration_domain
+  integration_path = var.integration_path
+  main_host = var.main_host
+  proxy_secret = var.proxy_secret
+  fastly_api_token = var.fastly_api_token
+}

examples/main/providers.tf

@@ -0,0 +1,17 @@
+terraform {
+  required_version = ">= 1.5"
+  required_providers {
+    fastly = {
+      source  = "fastly/fastly"
+      version = ">= 7.1.0"
+    }
+    github = {
+      source  = "integrations/github"
+      version = "6.2.2"
+    }
+  }
+}
+
+provider "fastly" {
+  api_key = var.fastly_api_token
+}

examples/main/terraform.tfvars.example

@@ -0,0 +1,7 @@
+agent_script_download_path  = "463N7"
+get_result_path             = "r35U17"
+integration_path            = "zyk12Xc"
+proxy_secret                = "YOUR_PROXY_SECRET_KEY_CREATED_IN_FINGERPRINT_DASHBOARD"
+fastly_api_token            = "YOUR_API_TOKEN_CREATED_IN_FASTLY_DASHBOARD"
+integration_domain          = "metrics.yourwebsite.com"
+main_host                   = "origin.yourwebsite.com"

examples/main/variables.tf

@@ -0,0 +1,36 @@
+variable "agent_script_download_path" {
+  description = "The Fingerprint agent download will be proxied through this path"
+  type = string
+  default = "agent"
+}
+
+variable "get_result_path" {
+  description = "The Fingerprint agent download will be proxied through this path"
+  type = string
+  default = "result"
+}
+
+variable "integration_path" {
+  description = "The Fingerprint integration will be proxied through this path prefix"
+  type = string
+  default = "integration"
+}
+
+variable "integration_domain" {
+  description = "Domain used for your proxy integration"
+  type = string
+}
+
+variable "main_host" {
+  description = "Your origin server domain"
+  type = string
+}
+
+variable "proxy_secret" {
+  description = "Your Fingerprint proxy secret"
+  type = string
+}
+
+variable "fastly_api_token" {
+  type = string
+}