Release 0.1.4 (#5)

* Release 0.1.3

* terraform version >= 1.3.0

* chore: release notes and version bump

* feat: module tag updated to ocilz-terraform-module

* chore: release notes updated

* doc: SPECs updated

---------

Co-authored-by: Erna Guerrero <[email protected]>

Author: andrecorreaneto

RELEASE-NOTES.md

@@ -1,3 +1,8 @@
+# August 27, 2024 Release Notes - 0.1.4
+## Updates
+1. All modules now require Terraform binary equal or greater than 1.3.0.
+2. *cislz-terraform-module* tag renamed to *ocilz-terraform-module*.
+
 # July 24, 2024 Release Notes - 0.1.3
 ## Updates    
 1. Aligned [README.md](./README.md) structure to Oracle's GitHub organizations requirements.

budgets/README.md

@@ -15,6 +15,10 @@ Check the [examples](./examples/) folder for actual module usage.
 - [Known Issues](#issues)
 
 ## <a name="requirements">Requirements</a>
+
+### Terraform Version >= 1.3.0
+This module requires Terraform binary version 1.3.0 or greater, as it relies on Optional Object Type Attributes feature. The feature shortens the amount of input values in complex object types, by having Terraform automatically inserting a default value for any missing optional attributes.
+
 ### IAM Permissions
 
 This module requires the following OCI IAM permission:
@@ -25,27 +29,6 @@ Allow group <group> to manage usage-budgets in tenancy
 
 **Note:** Budgets are always created in the Root compartment, regardless the compartment they target.
 
-### Terraform Version < 1.3.x and Optional Object Type Attributes
-This module relies on [Terraform Optional Object Type Attributes feature](https://developer.hashicorp.com/terraform/language/expressions/type-constraints#optional-object-type-attributes), which is experimental from Terraform 0.14.x to 1.2.x. It shortens the amount of input values in complex object types, by having Terraform automatically inserting a default value for any missing optional attributes. The feature has been promoted and it is no longer experimental in Terraform 1.3.x.
-
-**As is, this module can only be used with Terraform versions up to 1.2.x**, because it can be consumed by other modules via [OCI Resource Manager service](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/home.htm), that still does not support Terraform 1.3.x.
-
-Upon running *terraform plan* with Terraform versions prior to 1.3.x, Terraform displays the following warning:
-```
-Warning: Experimental feature "module_variable_optional_attrs" is active
-```
-
-Note the warning is harmless. The code has been tested with Terraform 1.3.x and the implementation is fully compatible.
-
-If you really want to use Terraform 1.3.x, in [providers.tf](./providers.tf):
-1. Change the terraform version requirement to:
-```
-required_version = ">= 1.3.0"
-```
-2. Remove the line:
-```
-experiments = [module_variable_optional_attrs]
-```
 ## <a name="invoke">How to Invoke the Module</a>
 
 Terraform modules can be invoked locally or remotely. 

budgets/SPEC.md

@@ -2,7 +2,7 @@
 
 | Name | Version |
 |------|---------|
-| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | < 1.3.0 |
+| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.3.0 |
 
 ## Providers
 
@@ -25,7 +25,7 @@ No modules.
 
 | Name | Description | Type | Default | Required |
 |------|-------------|------|---------|:--------:|
-| <a name="input_budgets_configuration"></a> [budgets\_configuration](#input\_budgets\_configuration) | n/a | <pre>object({<br>    #default_compartment_id   = optional(string),<br>    default_defined_tags     = optional(map(string)),<br>    default_freeform_tags    = optional(map(string))<br>    budgets = optional(map(object({<br>      #compartment_id   = optional(string),<br>      name             = string,<br>      description      = optional(string),<br>      target           = optional(object({<br>        type   = optional(string), # Default: COMPARTMENT<br>        values = optional(list(string)) # Default: [<tenancy_ocid>]<br>      })),<br>      amount = number,<br>      schedule = optional(object({<br>        reset_period = optional(string), # Default: MONTHLY<br>        processing_period_type = optional(string) # Default: MONTH. Valid values: MONTH, SINGLE_USE.<br>        day_of_month_to_begin = optional(number), # Only applicable when processing_period_type is MONTH. Default: <current day>.<br>        single_use_start_date = optional(string), # Only applicable when processing_period_type is SINGLE_USE.<br>        single_use_end_date = optional(string) # Only applicable when processing_period_type is SINGLE_USE.<br>      })),<br>      defined_tags     = optional(map(string)),<br>      freeform_tags    = optional(map(string)),<br>      alert_rule       = optional(object({<br>        name             = optional(string)<br>        description      = optional(string)<br>        threshold_metric = optional(string), # Default: ACTUAL<br>        threshold_type   = optional(string), # Default: PERCENTAGE<br>        threshold_value  = number,<br>        recipients       = optional(string),<br>        message          = optional(string),<br>        defined_tags     = optional(map(string)),<br>        freeform_tags    = optional(map(string))<br>      }))<br>    })))<br>  })</pre> | n/a | yes |
+| <a name="input_budgets_configuration"></a> [budgets\_configuration](#input\_budgets\_configuration) | n/a | <pre>object({<br>    #default_compartment_id   = optional(string),<br>    default_defined_tags     = optional(map(string)),<br>    default_freeform_tags    = optional(map(string))<br>    budgets = optional(map(object({<br>      #compartment_id   = optional(string),<br>      name             = string,<br>      description      = optional(string),<br>      target           = optional(object({<br>        type   = optional(string), # Default: COMPARTMENT<br>        values = optional(list(string)) # Default: [<tenancy_ocid>]<br>      })),<br>      amount = number,<br>      schedule = optional(object({<br>        reset_period = optional(string), # Default: MONTHLY<br>        processing_period_type = optional(string) # Default: MONTH. Valid values: MONTH, SINGLE_USE.<br>        day_of_month_to_begin = optional(number), # Only applicable when processing_period_type is MONTH. Default: <current day>.<br>        single_use_start_date = optional(string), # Only applicable when processing_period_type is SINGLE_USE.<br>        single_use_end_date = optional(string) # Only applicable when processing_period_type is SINGLE_USE.<br>      })),<br>      defined_tags     = optional(map(string)),<br>      freeform_tags    = optional(map(string)),<br>      alert_rule       = optional(object({<br>        name             = optional(string)<br>        description      = optional(string)<br>        threshold_metric = optional(string), # Default: ACTUAL<br>        threshold_type   = optional(string), # Default: PERCENTAGE<br>        threshold_value  = number,<br>        recipients       = string,<br>        message          = string,<br>        defined_tags     = optional(map(string)),<br>        freeform_tags    = optional(map(string))<br>      }))<br>    })))<br>  })</pre> | n/a | yes |
 | <a name="input_compartments_dependency"></a> [compartments\_dependency](#input\_compartments\_dependency) | A map of objects containing the externally managed compartments this module may depend on. All map objects must have the same type and must contain at least an 'id' attribute (representing the compartment OCID) of string type. | `map(any)` | `null` | no |
 | <a name="input_module_name"></a> [module\_name](#input\_module\_name) | The module name. | `string` | `"budgets"` | no |
 | <a name="input_tenancy_ocid"></a> [tenancy\_ocid](#input\_tenancy\_ocid) | n/a | `any` | n/a | yes |

budgets/examples/compartment-based-budget/provider.tf

@@ -11,11 +11,10 @@ provider "oci" {
 }
 
 terraform {
-  required_version = "< 1.3.0"
+  required_version = ">= 1.3.0"
   required_providers {
     oci = {
       source = "oracle/oci"
     }
   }
-  experiments = [module_variable_optional_attrs]
-} 
+}

budgets/examples/minimal-config-budget/provider.tf

@@ -11,11 +11,10 @@ provider "oci" {
 }
 
 terraform {
-  required_version = "< 1.3.0"
+  required_version = ">= 1.3.0"
   required_providers {
     oci = {
       source = "oracle/oci"
     }
   }
-  experiments = [module_variable_optional_attrs]
-} 
+}

budgets/examples/tag-based-budget/provider.tf

@@ -11,11 +11,10 @@ provider "oci" {
 }
 
 terraform {
-  required_version = "< 1.3.0"
+  required_version = ">= 1.3.0"
   required_providers {
     oci = {
       source = "oracle/oci"
     }
   }
-  experiments = [module_variable_optional_attrs]
-} 
+}

budgets/metadata.tf

@@ -3,5 +3,5 @@
 
 #-- Used to inform module and release number.
 locals {
-    cislz_module_tag = {"cislz-terraform-module" : fileexists("${path.module}/../release.txt") ? "${var.module_name}/${file("${path.module}/../release.txt")}" : "${var.module_name}"}
+    cislz_module_tag = {"ocilz-terraform-module" : fileexists("${path.module}/../release.txt") ? "${var.module_name}/${file("${path.module}/../release.txt")}" : "${var.module_name}"}
 }    

budgets/providers.tf

@@ -2,11 +2,10 @@
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
 
 terraform {
-  required_version = "< 1.3.0"
+  required_version = ">= 1.3.0"
   required_providers {
     oci = {
       source = "oracle/oci"
     }
   }
-  experiments = [module_variable_optional_attrs]
-} 
+}

release.txt

@@ -1 +1 @@
-0.1.3
+0.1.4

tags/README.md

@@ -17,6 +17,10 @@ Check the [examples](./examples/) folder for module usage with actual input data
 - [Known Issues](#issues)
 
 ## <a name="requirements">Requirements</a>
+
+### Terraform Version >= 1.3.0
+This module requires Terraform binary version 1.3.0 or greater, as it relies on Optional Object Type Attributes feature. The feature shortens the amount of input values in complex object types, by having Terraform automatically inserting a default value for any missing optional attributes.
+
 ### IAM Permissions
 
 This module requires the following OCI IAM permissions:
@@ -41,27 +45,6 @@ If *\<COMPARTMENT-OCID\>* is the root compartment (tenancy level), the permissio
 Allow group <group> to manage tag-defaults in tenancy
 Allow group <group> to inspect tag-namespaces in tenancy
 ```
-### Terraform Version < 1.3.x and Optional Object Type Attributes
-This module relies on [Terraform Optional Object Type Attributes feature](https://developer.hashicorp.com/terraform/language/expressions/type-constraints#optional-object-type-attributes), which is experimental from Terraform 0.14.x to 1.2.x. It shortens the amount of input values in complex object types, by having Terraform automatically inserting a default value for any missing optional attributes. The feature has been promoted and it is no longer experimental in Terraform 1.3.x.
-
-**As is, this module can only be used with Terraform versions up to 1.2.x**, because it can be consumed by other modules via [OCI Resource Manager service](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/home.htm), that still does not support Terraform 1.3.x.
-
-Upon running *terraform plan* with Terraform versions prior to 1.3.x, Terraform displays the following warning:
-```
-Warning: Experimental feature "module_variable_optional_attrs" is active
-```
-
-Note the warning is harmless. The code has been tested with Terraform 1.3.x and the implementation is fully compatible.
-
-If you really want to use Terraform 1.3.x, in [providers.tf](./providers.tf):
-1. Change the terraform version requirement to:
-```
-required_version = ">= 1.3.0"
-```
-2. Remove the line:
-```
-experiments = [module_variable_optional_attrs]
-```
 
 ## <a name="invoke">How to Invoke the Module</a>