SDCD-2163 | Add docs on terraform

content/en/deployment_gates/setup.md

@@ -107,6 +107,50 @@
 {{% /tab %}}
 {{< /tabs >}}
 
+## Managing Deployment Gates
+
+You can manage Deployment Gates via the UI, API or Terraform.
+
+- **API**: You can use the [Deployment Gates API][1] to create and manage Deployment Gates.
+- **Terraform**: You can use the [Datadog Terraform provider][2] to create and manage Deployment Gates. For example:
+
+```yaml
+# Create new deployment_gate resource
+
+resource "datadog_deployment_gate" "foo" {
+  dry_run    = "false"
+  env        = "production"
+  identifier = "my-gate"
+  service    = "my-service"
+
+  rule {
+    name    = "fdd"
+    type    = "faulty_deployment_detection"
+    dry_run = false
+    options {
+      duration           = 1300
+      excluded_resources = ["GET api/v1/test"]
+    }
+  }
+
+  rule {
+    name    = "monitor"
+    type    = "monitor"
+    dry_run = false
+    options {
+      query    = "service:test-service"
+      duration = 1300
+    }
+  }
+}
+```
+
+Will create a deployment gate and it will be completely managed by terraform. Any changes to the gate applied in the UI will be overwritten by the terraform configuration.
+
+
+[1]: https://docs.datadoghq.com/api/latest/deployment-gates/
+[2]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/deployment_gate
+
 ## Evaluate Deployment Gates
 
 Once you have configured the gates and rules, you can request a gate evaluation when deploying the related service, and decide whether to block or continue the deployment based on the result.