terraform

Author: patriciasantaana

src/content/docs/turnstile/get-started/widget-management/terraform.mdx

@@ -23,7 +23,7 @@ Before you begin, you must have:
 
 Create a `main.tf` file.
 
-```tf title="cloudflare.tf"
+```tf
 terraform {
   required_providers {
     cloudflare = {
@@ -51,3 +51,140 @@ variable "account_id" {
 
 ### 2. Define widgets
 
+```tf
+resource "cloudflare_turnstile_widget" "login_form" {
+  account_id = var.account_id
+  name       = "Login Form Widget"
+  domains    = ["example.com", "www.example.com"]
+  mode       = "managed"
+  region     = "world"
+}
+
+resource "cloudflare_turnstile_widget" "api_protection" {
+  account_id = var.account_id
+  name       = "API Protection"
+  domains    = ["api.example.com"]
+  mode       = "invisible"
+  region     = "world"
+}
+
+# Output the sitekeys for use in your application
+output "login_sitekey" {
+  value = cloudflare_turnstile_widget.login_form.sitekey
+}
+
+output "api_sitekey" {
+  value = cloudflare_turnstile_widget.api_protection.sitekey
+}
+```
+
+### 3. Environment variables
+
+Create a `.env` file or set environment variables.
+
+```shell
+export TF_VAR_cloudflare_api_token="your-api-token"
+export TF_VAR_account_id="your-account-id"
+```
+
+---
+
+## Terraform commands
+
+### Initialize and plan
+
+```shell title="Initialize Terraform"
+terraform init
+```
+
+```shell title="Plan changes"
+terraform plan
+```
+
+```shell title="Apply configuration"
+terraform apply
+```
+
+### Manage changes
+
+```shell title="Update widget configuration"
+terraform plan
+```
+
+```shell title="Apply changes"
+terraform apply
+```
+
+```shell title="Destroy widgets"
+terraform destroy
+```
+
+---
+
+## Advanced Terraform configuration
+
+### Multiple environments
+
+```tf
+locals {
+  environments = {
+    dev = {
+      domains = ["dev.example.com"]
+      mode    = "managed"
+    }
+    staging = {
+      domains = ["staging.example.com"]
+      mode    = "non_interactive"
+    }
+    prod = {
+      domains = ["example.com", "www.example.com"]
+      mode    = "invisible"
+    }
+  }
+}
+
+resource "cloudflare_turnstile_widget" "app_widget" {
+  for_each = local.environments
+  
+  account_id = var.account_id
+  name       = "App Widget - ${each.key}"
+  domains    = each.value.domains
+  mode       = each.value.mode
+  region     = "world"
+}
+```
+
+### Widget with Enterprise features
+
+```tf
+resource "cloudflare_turnstile_widget" "enterprise_widget" {
+  account_id     = var.account_id
+  name          = "Enterprise Form"
+  domains       = ["enterprise.example.com"]
+  mode          = "managed"
+  region        = "world"
+  offlabel      = true  # Remove Cloudflare branding
+  bot_fight_mode = true # Enable bot fight mode
+}
+```
+
+---
+
+## Import existing widgets
+
+Use `cf-terraforming` to import existing widgets.
+
+```shell title="Install cf-terraforming"
+go install github.com/cloudflare/cf-terraforming/cmd/cf-terraforming@latest
+```
+
+```shell title="Generate Terraform configuration from existing widgets"
+cf-terraforming generate \
+  --resource-type cloudflare_turnstile_widget \
+  --account $ACCOUNT_ID
+```
+
+```shell title="Import existing widget"
+terraform import cloudflare_turnstile_widget.existing_widget \
+  $ACCOUNT_ID/$WIDGET_SITEKEY
+```