prepare 2.18.3 release

docs/data-sources/environment.md

@@ -30,6 +30,10 @@ data "launchdarkly_environment" "example" {
 - `key` (String) The project-unique key for the environment.
 - `project_key` (String) The environment's project key.
 
+### Optional
+
+- `critical` (Boolean) Denotes whether the environment is critical.
+
 ### Read-Only
 
 - `api_key` (String, Sensitive) The environment's SDK key.

docs/resources/environment.md

@@ -59,6 +59,7 @@ resource "launchdarkly_environment" "approvals_example" {
 
 - `approval_settings` (Block List) (see [below for nested schema](#nestedblock--approval_settings))
 - `confirm_changes` (Boolean) Set to `true` if this environment requires confirmation for flag and segment changes. This field will default to `false` when not set.
+- `critical` (Boolean) Denotes whether the environment is critical.
 - `default_track_events` (Boolean) Set to `true` to enable data export for every flag created in this environment after you configure this argument. This field will default to `false` when not set. To learn more, read [Data Export](https://docs.launchdarkly.com/home/data-export).
 - `default_ttl` (Number) The TTL for the environment. This must be between 0 and 60 minutes. The TTL setting only applies to environments using the PHP SDK. This field will default to `0` when not set. To learn more, read [TTL settings](https://docs.launchdarkly.com/home/organize/environments#ttl-settings).
 - `require_comments` (Boolean) Set to `true` if this environment requires comments for flag and segment changes. This field will default to `false` when not set.

docs/resources/feature_flag_environment.md

@@ -19,6 +19,7 @@ This resource allows you to create and manage environment-specific feature flags
 ## Example Usage
 
 ```terraform
+# This example shows the use of prerequisites, targets, context targets, rules, and fallthrough for a feature flag environment
 resource "launchdarkly_feature_flag_environment" "number_ff_env" {
   flag_id = launchdarkly_feature_flag.number.id
   env_key = launchdarkly_environment.staging.key
@@ -68,6 +69,115 @@ resource "launchdarkly_feature_flag_environment" "number_ff_env" {
   }
   off_variation = 2
 }
+
+# This example shows the minimum configuration required to create a feature flag environment
+resource "launchdarkly_feature_flag_environment" "basic_flag_environment" {
+  flag_id = launchdarkly_feature_flag.basic_flag.id
+  env_key = "development"
+
+  on = true
+
+  fallthrough {
+    variation = 1
+  }
+  off_variation = 0
+}
+
+# This example shows a feature flag environment with a targeting rule that uses every clause operator
+resource "launchdarkly_feature_flag_environment" "big_flag_environment" {
+  flag_id = launchdarkly_feature_flag.big_flag.id
+  env_key = "development"
+
+  on = true
+
+  rules {
+    description = "Example targeting rule with every clause operator"
+    clauses {
+      attribute = "username"
+      op        = "in" // Maps to 'is one of' in the UI
+      values    = ["henrietta powell", "wally waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "endsWith" // Maps to 'ends with' in the UI
+      values    = ["powell", "waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "startsWith" // Maps to 'starts with' in the UI
+      values    = ["henrietta", "wally"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "matches" // Maps to 'matches regex' in the UI
+      values    = ["henr*"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "contains" // Maps to 'contains' in the UI
+      values    = ["water"]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThan" // Maps to 'less than (<)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThanOrEqual" // Maps to 'less than or equal to (<=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThan" // Maps to 'greater than (>)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThanOrEqual" // Maps to 'greater than or equal to (>=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "before" // Maps to 'before' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "after" // Maps to 'after' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerEqual" // Maps to 'semantic version is one of (=)' in the UI
+      values       = ["1.0.0", "1.0.1"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerLessThan" // Maps to 'semantic version less than (<)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerGreaterThan" // Maps to 'semantic version greater than (>)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute = "context"
+      op        = "segmentMatch" // Maps to 'Context is in' in the UI
+      values    = ["test-segment"]
+    }
+    variation = 0
+  }
+
+  fallthrough {
+    variation = 1
+  }
+  off_variation = 0
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
@@ -140,7 +250,7 @@ Optional:
 Required:
 
 - `attribute` (String) The user attribute to operate on
-- `op` (String) The operator associated with the rule clause. Available options are `in`, `endsWith`, `startsWith`, `matches`, `contains`, `lessThan`, `lessThanOrEqual`, `greaterThanOrEqual`, `before`, `after`, `segmentMatch`, `semVerEqual`, `semVerLessThan`, and `semVerGreaterThan`.
+- `op` (String) The operator associated with the rule clause. Available options are `in`, `endsWith`, `startsWith`, `matches`, `contains`, `lessThan`, `lessThanOrEqual`, `greaterThanOrEqual`, `before`, `after`, `segmentMatch`, `semVerEqual`, `semVerLessThan`, and `semVerGreaterThan`. Read LaunchDarkly's [Operators](https://docs.launchdarkly.com/sdk/concepts/flag-evaluation-rules#operators) documentation for more information.
 - `values` (List of String) The list of values associated with the rule clause.
 
 Optional:

docs/resources/segment.md

@@ -16,6 +16,7 @@ This resource allows you to create and manage segments within your LaunchDarkly
 ## Example Usage
 
 ```terraform
+# This example shows the use of tags, targets, context targets, and rules for a segment
 resource "launchdarkly_segment" "example" {
   key         = "example-segment-key"
   project_key = launchdarkly_project.example.key
@@ -41,6 +42,7 @@ resource "launchdarkly_segment" "example" {
   }
 }
 
+# This example shows a segment configured to have an unbounded number of individual targets
 resource "launchdarkly_segment" "big-example" {
   key                    = "example-big-segment-key"
   project_key            = launchdarkly_project.example.key
@@ -51,6 +53,95 @@ resource "launchdarkly_segment" "big-example" {
   unbounded              = true
   unbounded_context_kind = "user"
 }
+
+# This example shows a segment with a targeting rule that uses all clause operators
+resource "launchdarkly_segment" "segment_with_all_clause_operators" {
+  name        = "Segment with all clause operators"
+  key         = "segment-operators"
+  project_key = "projectx"
+  env_key     = "development"
+
+  rules {
+    clauses {
+      attribute = "username"
+      op        = "in" // Maps to 'is one of' in the UI
+      values    = ["henrietta powell", "wally waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "endsWith" // Maps to 'ends with' in the UI
+      values    = ["powell", "waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "startsWith" // Maps to 'starts with' in the UI
+      values    = ["henrietta", "wally"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "matches" // Maps to 'matches regex' in the UI
+      values    = ["henr*"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "contains" // Maps to 'contains' in the UI
+      values    = ["water"]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThan" // Maps to 'less than (<)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThanOrEqual" // Maps to 'less than or equal to (<=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThan" // Maps to 'greater than (>)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThanOrEqual" // Maps to 'greater than or equal to (>=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "before" // Maps to 'before' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "after" // Maps to 'after' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerEqual" // Maps to 'semantic version is one of (=)' in the UI
+      values       = ["1.0.0", "1.0.1"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerLessThan" // Maps to 'semantic version less than (<)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerGreaterThan" // Maps to 'semantic version greater than (>)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute = "context"
+      op        = "segmentMatch" // Maps to 'Context is in' in the UI
+      values    = ["test-segment"]
+    }
+  }
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
@@ -114,7 +205,7 @@ Optional:
 Required:
 
 - `attribute` (String) The user attribute to operate on
-- `op` (String) The operator associated with the rule clause. Available options are `in`, `endsWith`, `startsWith`, `matches`, `contains`, `lessThan`, `lessThanOrEqual`, `greaterThanOrEqual`, `before`, `after`, `segmentMatch`, `semVerEqual`, `semVerLessThan`, and `semVerGreaterThan`.
+- `op` (String) The operator associated with the rule clause. Available options are `in`, `endsWith`, `startsWith`, `matches`, `contains`, `lessThan`, `lessThanOrEqual`, `greaterThanOrEqual`, `before`, `after`, `segmentMatch`, `semVerEqual`, `semVerLessThan`, and `semVerGreaterThan`. Read LaunchDarkly's [Operators](https://docs.launchdarkly.com/sdk/concepts/flag-evaluation-rules#operators) documentation for more information.
 - `values` (List of String) The list of values associated with the rule clause.
 
 Optional:

examples/resources/launchdarkly_feature_flag_environment/resource.tf

@@ -1,3 +1,4 @@
+# This example shows the use of prerequisites, targets, context targets, rules, and fallthrough for a feature flag environment
 resource "launchdarkly_feature_flag_environment" "number_ff_env" {
   flag_id = launchdarkly_feature_flag.number.id
   env_key = launchdarkly_environment.staging.key
@@ -47,3 +48,112 @@ resource "launchdarkly_feature_flag_environment" "number_ff_env" {
   }
   off_variation = 2
 }
+
+# This example shows the minimum configuration required to create a feature flag environment
+resource "launchdarkly_feature_flag_environment" "basic_flag_environment" {
+  flag_id = launchdarkly_feature_flag.basic_flag.id
+  env_key = "development"
+
+  on = true
+
+  fallthrough {
+    variation = 1
+  }
+  off_variation = 0
+}
+
+# This example shows a feature flag environment with a targeting rule that uses every clause operator
+resource "launchdarkly_feature_flag_environment" "big_flag_environment" {
+  flag_id = launchdarkly_feature_flag.big_flag.id
+  env_key = "development"
+
+  on = true
+
+  rules {
+    description = "Example targeting rule with every clause operator"
+    clauses {
+      attribute = "username"
+      op        = "in" // Maps to 'is one of' in the UI
+      values    = ["henrietta powell", "wally waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "endsWith" // Maps to 'ends with' in the UI
+      values    = ["powell", "waterbear"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "startsWith" // Maps to 'starts with' in the UI
+      values    = ["henrietta", "wally"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "matches" // Maps to 'matches regex' in the UI
+      values    = ["henr*"]
+    }
+    clauses {
+      attribute = "username"
+      op        = "contains" // Maps to 'contains' in the UI
+      values    = ["water"]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThan" // Maps to 'less than (<)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "lessThanOrEqual" // Maps to 'less than or equal to (<=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThan" // Maps to 'greater than (>)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "pageVisits"
+      op        = "greaterThanOrEqual" // Maps to 'greater than or equal to (>=)' in the UI
+      values    = [100]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "before" // Maps to 'before' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute = "creationDate"
+      op        = "after" // Maps to 'after' in the UI
+      values    = ["2024-05-03T15:57:30Z"]
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerEqual" // Maps to 'semantic version is one of (=)' in the UI
+      values       = ["1.0.0", "1.0.1"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerLessThan" // Maps to 'semantic version less than (<)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute    = "version"
+      op           = "semVerGreaterThan" // Maps to 'semantic version greater than (>)' in the UI
+      values       = ["1.0.0"]
+      context_kind = "application"
+    }
+    clauses {
+      attribute = "context"
+      op        = "segmentMatch" // Maps to 'Context is in' in the UI
+      values    = ["test-segment"]
+    }
+    variation = 0
+  }
+
+  fallthrough {
+    variation = 1
+  }
+  off_variation = 0
+}