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

INTMDB-244: add deprecation notes for cloud backup documentation #525

Merged
merged 14 commits into from
Aug 26, 2021

Conversation

abner-dou
Copy link
Contributor

Description

Marked some resources and datasources as deprecated, also cluster documentation was updated

Link to any related issue(s):

Type of change:

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update
  • Documentation fix/enhancement

Required Checklist:

  • I have signed the MongoDB CLA
  • I have read the Terraform contribution guidelines
  • I have added tests that prove my fix is effective or that my feature works per HashiCorp requirements
  • I have added any necessary documentation (if appropriate)
  • I have run make fmt and formatted my code

Further comments

@abner-dou abner-dou requested a review from themantissa as a code owner August 24, 2021 20:03
@themantissa themantissa requested review from a team and gssbzn and removed request for a team August 24, 2021 20:17
Copy link
Collaborator

@themantissa themantissa left a comment

Choose a reason for hiding this comment

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

In all the examples for cluster in other resources did you check for provider_backup_enabled = true and replace it? I'm pretty sure there's a bunch out there a simple find and replace should fix. Other issues are noted inline.

@@ -33,7 +33,7 @@ resource "mongodbatlas_cluster" "test" {
read_only_nodes = 0
}
}
provider_backup_enabled = true
cloud_backup_config = true
Copy link
Collaborator

Choose a reason for hiding this comment

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

Which is it? In @coderGo93's add to the guide it states:
IMPORTANT In resource mongodbatlas_cluster the parameter provider_backup_enabled has been deprecated, use cloud_backup instead.
Now this has cloud_backup_config. Looks like cloud_backup: https://github.com/mongodb/terraform-provider-mongodbatlas/blob/master/mongodbatlas/resource_mongodbatlas_cluster.go#L151. Looking at rest maybe a typo?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

this was a typo (autocomplete feature don't help me in this)

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes, it seems its a typo, it should be cloud_backup

website/docs/r/cluster.html.markdown Show resolved Hide resolved
@@ -279,11 +279,11 @@ But in order to explicitly change `provider_instance_size_name` comment the `lif

* `backup_enabled` - (Optional) Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
**Important** - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using [Cloud Backups](https://docs.atlas.mongodb.com/backup/cloud-backup/overview/).
* Any net new Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup, `provider_backup_enabled`, to enable Cloud Backup. If you create a new Atlas cluster and set `backup_enabled` to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups.
* Any net new Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup, `cloud_backup`, to enable Cloud Backup. If you create a new Atlas cluster and set `backup_enabled` to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* Any net new Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup, `cloud_backup`, to enable Cloud Backup. If you create a new Atlas cluster and set `backup_enabled` to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups.
* New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup, `cloud_backup`, to enable Cloud Backup. If you create a new Atlas cluster and set `backup_enabled` to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I already fixed this :D

Copy link
Collaborator

@gssbzn gssbzn left a comment

Choose a reason for hiding this comment

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

From my side LGTM with one small improvement to the copy, @themantissa point may still need to be addressed but I also don't have full context here

@abner-dou abner-dou requested a review from themantissa August 25, 2021 21:29
@themantissa themantissa removed the request for review from andreaangiolillo August 25, 2021 22:39
Copy link
Collaborator

@themantissa themantissa left a comment

Choose a reason for hiding this comment

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

Very close, just a slight change in wording to make it deprecated now vs in the future.

website/docs/d/cluster.html.markdown Outdated Show resolved Hide resolved
@abner-dou abner-dou requested a review from themantissa August 25, 2021 23:02
Copy link
Collaborator

@themantissa themantissa left a comment

Choose a reason for hiding this comment

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

LGTM!

@abner-dou
Copy link
Contributor Author

@themantissa this PR is ready to merge :)

@themantissa themantissa merged commit 5ab41cc into mongodb:master Aug 26, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants