doc: Adds 1.19.0 release upgrade guide (#2564)

* upgrade guide skeleton

* initial EAR

* include changes from changelog

* minor

* Update docs/guides/1.19.0-upgrade-guide.md

Co-authored-by: Agustin Bettati <[email protected]>

* add TF modules

* stream processor

* add tf modules to index

* mention replica_set_scaling_strategy in the upgrade guide

* mention change_stream_options_pre_and_post_images_expire_after_seconds

---------

Co-authored-by: Agustin Bettati <[email protected]>
Co-authored-by: Oriol Arbusi <[email protected]>

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.

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.