diff --git a/docs/guides/1.19.0-upgrade-guide.md b/docs/guides/1.19.0-upgrade-guide.md new file mode 100644 index 000000000..0da8b5ba5 --- /dev/null +++ b/docs/guides/1.19.0-upgrade-guide.md @@ -0,0 +1,35 @@ +--- +page_title: "Upgrade Guide 1.19.0" +--- + +# MongoDB Atlas Provider 1.19.0: Upgrade and Information Guide + +The Terraform MongoDB Atlas Provider version 1.19.0 has a number of new and exciting features. + +**New Resources, Data Sources, and Features:** +- You can now [manage customer keys from Azure Key Vault over Private Endpoints](https://www.mongodb.com/docs/atlas/security/azure-kms-over-private-endpoint/#manage-customer-keys-with-azure-key-vault-over-private-endpoints) to further encrypt your data at rest in Atlas with the new `mongodbatlas_encryption_at_rest_private_endpoint` resource and data sources in conjunction with the existing `mongodbatlas_encryption_at_rest` resource. + - In order to configure a private endpoint for your Azure Key Vault, the corresponding `mongodbatlas_encryption_at_rest` resource has to be adjusted by configuring `azure_key_vault_config.require_private_networking` to `true`. This attribute can be updated in place, ensuring the customer-managed keys encryption is never disabled. + - To learn more, please review `mongodbatlas_encryption_at_rest_private_endpoint` [resource documentation](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/encryption_at_rest_private_endpoint). + +- You can now use the new `mongodbatlas_project_ip_addresses` data source that returns the IP addresses in an Atlas project categorized by services. + +- You can now manage [Atlas Stream Processors](https://www.mongodb.com/docs/atlas/atlas-stream-processing/overview/) with the new `mongodbatlas_stream_processor` resource, `mongodbatlas_stream_processor` and `mongodbatlas_stream_processors` data sources. To learn more, please review `mongodbatlas_stream_processor` [resource documentation](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/stream_processor). + +- You can now configure the replica set scaling mode for `mongodbatlas_advanced_cluster` using `replica_set_scaling_strategy`. To learn more, please review `mongodbatlas_advanced_cluster` [resource documentation](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/advanced_cluster) + +- You can now configure the minimum pre- and post-image retention time for `mongodbatlas_advanced_cluster` and `mongodbatlas_cluster` using `change_stream_options_pre_and_post_images_expire_after_seconds`. To learn more, please review either [mongodbatlas_advanced_cluster](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/advanced_cluster#change_stream_options_pre_and_post_images_expire_after_seconds) or [mongodbatlas_cluster](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/cluster#change_stream_options_pre_and_post_images_expire_after_seconds) resource documentation. + +**Deprecations and removals:** +- `ip_addresses` attribute has been deprecated in `mongodbatlas_project` resource and data sources in favor of the new `mongodbatlas_project_ip_addresses` [data source](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/project_ip_addresses). + + +## New Terraform MongoDB Atlas modules +You can now leverage our [Terraform Modules](https://registry.terraform.io/namespaces/terraform-mongodbatlas-modules) to easily get started with MongoDB Atlas and critical features like [Push-based log export](https://registry.terraform.io/modules/terraform-mongodbatlas-modules/push-based-log-export/mongodbatlas/latest), [Private Endpoints](https://registry.terraform.io/modules/terraform-mongodbatlas-modules/private-endpoint/mongodbatlas/latest), etc. + +### Helpful Links + +* [Report bugs](https://github.com/mongodb/terraform-provider-mongodbatlas/issues) + +* [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723) + +* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above. diff --git a/docs/index.md b/docs/index.md index b2d5124fc..032d98e62 100644 --- a/docs/index.md +++ b/docs/index.md @@ -225,3 +225,6 @@ in our GitHub repo that will help both beginner and more advanced users. Have a good example you've created and want to share? Let us know the details via an [issue](https://github.com/mongodb/terraform-provider-mongodbatlas/issues) or submit a PR of your work to add it to the `examples` directory in our [GitHub repo](https://github.com/mongodb/terraform-provider-mongodbatlas/). + +## Terraform MongoDB Atlas Modules +You can now leverage our [Terraform Modules](https://registry.terraform.io/namespaces/terraform-mongodbatlas-modules) to easily get started with MongoDB Atlas and critical features like [Push-based log export](https://registry.terraform.io/modules/terraform-mongodbatlas-modules/push-based-log-export/mongodbatlas/latest), [Private Endpoints](https://registry.terraform.io/modules/terraform-mongodbatlas-modules/private-endpoint/mongodbatlas/latest), etc. \ No newline at end of file