Fnm/create strategy resource retention block

.gitignore

@@ -57,3 +57,5 @@ terraform/**/.terraform/*
 results.xml
 
 .DS_Store
+
+main.tf

docs/data-sources/lifecycles.md

@@ -47,8 +47,10 @@ Read-Only:
 - `name` (String) The name of the lifecycle.
 - `phase` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase))
 - `release_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--release_retention_policy))
+- `release_retention_with_strategy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--release_retention_with_strategy))
 - `space_id` (String) The space ID associated with this lifecycle.
 - `tentacle_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--tentacle_retention_policy))
+- `tentacle_retention_with_strategy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--tentacle_retention_with_strategy))
 
 <a id="nestedatt--lifecycles--phase"></a>
 ### Nested Schema for `lifecycles.phase`
@@ -63,7 +65,9 @@ Read-Only:
 - `name` (String) The name of the phase.
 - `optional_deployment_targets` (List of String) The optional deployment targets for this phase.
 - `release_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase--release_retention_policy))
+- `release_retention_with_strategy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase--release_retention_with_strategy))
 - `tentacle_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase--tentacle_retention_policy))
+- `tentacle_retention_with_strategy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase--tentacle_retention_with_strategy))
 
 <a id="nestedatt--lifecycles--phase--release_retention_policy"></a>
 ### Nested Schema for `lifecycles.phase.release_retention_policy`
@@ -75,6 +79,16 @@ Read-Only:
 - `unit` (String) The unit of time for the retention policy.
 
 
+<a id="nestedatt--lifecycles--phase--release_retention_with_strategy"></a>
+### Nested Schema for `lifecycles.phase.release_retention_with_strategy`
+
+Read-Only:
+
+- `quantity_to_keep` (Number) The quantity of releases to keep.
+- `strategy` (String) The retention strategy.
+- `unit` (String) The unit of time for the retention policy.
+
+
 <a id="nestedatt--lifecycles--phase--tentacle_retention_policy"></a>
 ### Nested Schema for `lifecycles.phase.tentacle_retention_policy`
 
@@ -85,6 +99,16 @@ Read-Only:
 - `unit` (String) The unit of time for the retention policy.
 
 
+<a id="nestedatt--lifecycles--phase--tentacle_retention_with_strategy"></a>
+### Nested Schema for `lifecycles.phase.tentacle_retention_with_strategy`
+
+Read-Only:
+
+- `quantity_to_keep` (Number) The quantity of releases to keep.
+- `strategy` (String) The retention strategy.
+- `unit` (String) The unit of time for the retention policy.
+
+
 
 <a id="nestedatt--lifecycles--release_retention_policy"></a>
 ### Nested Schema for `lifecycles.release_retention_policy`
@@ -96,6 +120,16 @@ Read-Only:
 - `unit` (String) The unit of time for the retention policy.
 
 
+<a id="nestedatt--lifecycles--release_retention_with_strategy"></a>
+### Nested Schema for `lifecycles.release_retention_with_strategy`
+
+Read-Only:
+
+- `quantity_to_keep` (Number) The quantity of releases to keep.
+- `strategy` (String) The retention strategy.
+- `unit` (String) The unit of time for the retention policy.
+
+
 <a id="nestedatt--lifecycles--tentacle_retention_policy"></a>
 ### Nested Schema for `lifecycles.tentacle_retention_policy`
 
@@ -106,3 +140,13 @@ Read-Only:
 - `unit` (String) The unit of time for the retention policy.
 
 
+<a id="nestedatt--lifecycles--tentacle_retention_with_strategy"></a>
+### Nested Schema for `lifecycles.tentacle_retention_with_strategy`
+
+Read-Only:
+
+- `quantity_to_keep` (Number) The quantity of releases to keep.
+- `strategy` (String) The retention strategy.
+- `unit` (String) The unit of time for the retention policy.
+
+

docs/resources/lifecycle.md

@@ -3,12 +3,23 @@ page_title: "octopusdeploy_lifecycle Resource - terraform-provider-octopusdeploy
 subcategory: ""
 description: |-
   This resource manages lifecycles in Octopus Deploy.
+  Lifecycle retention is set using either the retention_policy and retention_with_strategy blocks.
+  - When using an octopus version prior to 2025.3
+      - the release_retention_policy and tentacle_retention_policy blocks are used
+  - when using an octopus version 2025.3 or later
+      - the release_retention_with_strategy and tentacle_retention_with_strategy blocks may be used
 ---
 
 # octopusdeploy_lifecycle (Resource)
 
 This resource manages lifecycles in Octopus Deploy.
 
+Lifecycle retention is set using either the `retention_policy` and `retention_with_strategy` blocks.
+- When using an octopus version prior to `2025.3`
+	- the `release_retention_policy` and `tentacle_retention_policy` blocks are used
+- when using an octopus version `2025.3` or later
+	- the `release_retention_with_strategy` and `tentacle_retention_with_strategy` blocks may be used
+
 ## Example Usage
 
 ```terraform
@@ -64,9 +75,15 @@ resource "octopusdeploy_lifecycle" "example" {
 
 - `description` (String) The description of this lifecycle.
 - `phase` (Block List) Defines a phase in the lifecycle. (see [below for nested schema](#nestedblock--phase))
-- `release_retention_policy` (Block List) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--release_retention_policy))
+- `release_retention_policy` (Block List, Deprecated) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--release_retention_policy))
+- `release_retention_with_strategy` (Block List) Defines the retention policy for releases or tentacles.
+	- When this block is not included, the space-wide "Default" retention policy is used. 
+ 	- This block may only be used on Octopus server 2025.3 or later. (see [below for nested schema](#nestedblock--release_retention_with_strategy))
 - `space_id` (String) The space ID associated with this resource.
-- `tentacle_retention_policy` (Block List) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--tentacle_retention_policy))
+- `tentacle_retention_policy` (Block List, Deprecated) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--tentacle_retention_policy))
+- `tentacle_retention_with_strategy` (Block List) Defines the retention policy for releases or tentacles.
+	- When this block is not included, the space-wide "Default" retention policy is used. 
+ 	- This block may only be used on Octopus server 2025.3 or later. (see [below for nested schema](#nestedblock--tentacle_retention_with_strategy))
 
 ### Read-Only
 
@@ -87,8 +104,14 @@ Optional:
 - `is_priority_phase` (Boolean) Deployments will be prioritized in this phase
 - `minimum_environments_before_promotion` (Number) The number of units required before a release can enter the next phase. If 0, all environments are required.
 - `optional_deployment_targets` (List of String) Environment IDs in this phase that a release can be deployed to, but is not automatically deployed to
-- `release_retention_policy` (Block List) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--phase--release_retention_policy))
-- `tentacle_retention_policy` (Block List) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--phase--tentacle_retention_policy))
+- `release_retention_policy` (Block List, Deprecated) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--phase--release_retention_policy))
+- `release_retention_with_strategy` (Block List) Defines the retention policy for releases or tentacles.
+	- When this block is not included, the space-wide "Default" retention policy is used. 
+ 	- This block may only be used on Octopus server 2025.3 or later. (see [below for nested schema](#nestedblock--phase--release_retention_with_strategy))
+- `tentacle_retention_policy` (Block List, Deprecated) Defines the retention policy for releases or tentacles. (see [below for nested schema](#nestedblock--phase--tentacle_retention_policy))
+- `tentacle_retention_with_strategy` (Block List) Defines the retention policy for releases or tentacles.
+	- When this block is not included, the space-wide "Default" retention policy is used. 
+ 	- This block may only be used on Octopus server 2025.3 or later. (see [below for nested schema](#nestedblock--phase--tentacle_retention_with_strategy))
 
 <a id="nestedblock--phase--release_retention_policy"></a>
 ### Nested Schema for `phase.release_retention_policy`
@@ -100,6 +123,22 @@ Optional:
 - `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
 
 
+<a id="nestedblock--phase--release_retention_with_strategy"></a>
+### Nested Schema for `phase.release_retention_with_strategy`
+
+Required:
+
+- `strategy` (String) How retention will be set. Valid strategies are `Default`, `Forever`, and `Count`. The default value is `Default`.
+  - `strategy = "Default"`, is used if the retention is set by the space-wide default lifecycle retention policy. When `Default` is used, no other attributes can be set since the specific retention policy is no longer defined within this lifecycle.
+  - `strategy = "Forever"`, is used if items within this lifecycle should never be deleted.
+  - `strategy = "Count"`, is used if a specific number of days/releases should be kept.
+
+Optional:
+
+- `quantity_to_keep` (Number) The number of days/releases to keep. The default value is 30. If 0 then all are kept.
+- `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
+
+
 <a id="nestedblock--phase--tentacle_retention_policy"></a>
 ### Nested Schema for `phase.tentacle_retention_policy`
 
@@ -110,6 +149,22 @@ Optional:
 - `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
 
 
+<a id="nestedblock--phase--tentacle_retention_with_strategy"></a>
+### Nested Schema for `phase.tentacle_retention_with_strategy`
+
+Required:
+
+- `strategy` (String) How retention will be set. Valid strategies are `Default`, `Forever`, and `Count`. The default value is `Default`.
+  - `strategy = "Default"`, is used if the retention is set by the space-wide default lifecycle retention policy. When `Default` is used, no other attributes can be set since the specific retention policy is no longer defined within this lifecycle.
+  - `strategy = "Forever"`, is used if items within this lifecycle should never be deleted.
+  - `strategy = "Count"`, is used if a specific number of days/releases should be kept.
+
+Optional:
+
+- `quantity_to_keep` (Number) The number of days/releases to keep. The default value is 30. If 0 then all are kept.
+- `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
+
+
 
 <a id="nestedblock--release_retention_policy"></a>
 ### Nested Schema for `release_retention_policy`
@@ -121,6 +176,22 @@ Optional:
 - `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
 
 
+<a id="nestedblock--release_retention_with_strategy"></a>
+### Nested Schema for `release_retention_with_strategy`
+
+Required:
+
+- `strategy` (String) How retention will be set. Valid strategies are `Default`, `Forever`, and `Count`. The default value is `Default`.
+  - `strategy = "Default"`, is used if the retention is set by the space-wide default lifecycle retention policy. When `Default` is used, no other attributes can be set since the specific retention policy is no longer defined within this lifecycle.
+  - `strategy = "Forever"`, is used if items within this lifecycle should never be deleted.
+  - `strategy = "Count"`, is used if a specific number of days/releases should be kept.
+
+Optional:
+
+- `quantity_to_keep` (Number) The number of days/releases to keep. The default value is 30. If 0 then all are kept.
+- `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
+
+
 <a id="nestedblock--tentacle_retention_policy"></a>
 ### Nested Schema for `tentacle_retention_policy`
 
@@ -130,6 +201,22 @@ Optional:
 - `should_keep_forever` (Boolean) Indicates if items should never be deleted. The default value is false.
 - `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
 
+
+<a id="nestedblock--tentacle_retention_with_strategy"></a>
+### Nested Schema for `tentacle_retention_with_strategy`
+
+Required:
+
+- `strategy` (String) How retention will be set. Valid strategies are `Default`, `Forever`, and `Count`. The default value is `Default`.
+  - `strategy = "Default"`, is used if the retention is set by the space-wide default lifecycle retention policy. When `Default` is used, no other attributes can be set since the specific retention policy is no longer defined within this lifecycle.
+  - `strategy = "Forever"`, is used if items within this lifecycle should never be deleted.
+  - `strategy = "Count"`, is used if a specific number of days/releases should be kept.
+
+Optional:
+
+- `quantity_to_keep` (Number) The number of days/releases to keep. The default value is 30. If 0 then all are kept.
+- `unit` (String) The unit of quantity to keep. Valid units are Days or Items. The default value is Days.
+
 ## Import
 
 Import is supported using the following syntax:

go.mod

@@ -149,3 +149,4 @@ require (
 	google.golang.org/protobuf v1.34.2 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )
+