Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: Adds 1.19.0 release upgrade guide #2564

Merged
merged 10 commits into from
Sep 10, 2024
Merged
33 changes: 33 additions & 0 deletions docs/guides/1.19.0-upgrade-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
page_title: "Upgrade Guide 1.19.0"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As mentioned by Zuhair we can add a small note on the publishing of new terraform modules. Not a provider feature precisely, but we can mention as a side note.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good point, let me add

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added

---

# 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).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

second link does not yet exists, but will once the documentation for 1.19.0 is published in the registry


- 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)

**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.
3 changes: 3 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -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.
maastha marked this conversation as resolved.
Show resolved Hide resolved