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

Display custom backup error #446

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Display custom backup error #446

wants to merge 3 commits into from

Conversation

Juju-archy
Copy link
Contributor

@Juju-archy Juju-archy commented Nov 21, 2024

Describe your PR

This PR updates the backup documentation to clarify the behavior of custom backup configurations with multiple retention policies and periods. It explains that while the Clever Cloud console does not display all backups for restoration, users can leverage the CLI to restore a specific backup.

=> CRISP ticket : https://app.crisp.chat/website/522c93ff-8b4d-4619-bcaf-e8d79ec492a0/inbox/session_401f3070-c3e3-4afe-af6b-cecf8a8d1f2b/

@Juju-archy Juju-archy added the documentation Improvements or additions to documentation label Nov 21, 2024
@Juju-archy Juju-archy self-assigned this Nov 21, 2024
Copy link

Deployment has finished 👁️👄👁️ Your app is available here

Co-authored-by: David Legrand <1110600+davlgd@users.noreply.github.com>
Copy link

🚀 You updated your review app. Check it here

Copy link

github-actions bot commented Dec 2, 2024

🚀 You updated your review app. Check it here

@@ -210,3 +210,6 @@ If a VACUUM operation needs more disk that there is remaining, migrating to the
Clever Cloud store all your backups on [Cellar](https://www.clever-cloud.com/product/cellar-object-storage/).
Cellar has a replication system to protect the data stored inside. It creates three copies of your backups, each stored in a different datacenters in the PAR region.
This way, even if one datacenter has an accident, your backup are still safe in two different datacenters.

If you have a custom backup configuration with multiple retention policies and periods, the Clever Cloud console will not display all the available backups for restoration.
Copy link
Member

Choose a reason for hiding this comment

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

This is not related to back-ups. This is more generic any custom change (conf, replica, back-ups, extensions) would be plot in the Clever Cloud console.

Not sure we should add a dedicated line for the back-ups only but something more generic maybe?

Copy link
Member

Choose a reason for hiding this comment

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

@aurrelhebert Yes. Could you suggest a change please ? Keep in mind that we are in the back-ups section of the FAQ here. It it needs to be generic beyond back-ups, maybe a new issue should be made to address custom changes in general.

Copy link
Contributor

Choose a reason for hiding this comment

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

I agree with Aurélien. This disclaimer is only valid for highly customized backups policies which doesn't concern 99% of our customers. It feels more like some information we should give to the customer alongside the setup ticket.

Cellar has a replication system to protect the data stored inside. It creates three copies of your backups, each stored in a different datacenters in the PAR region.
This way, even if one datacenter has an accident, your backup are still safe in two different datacenters.

If you have a custom backup configuration with multiple retention policies and periods, the Clever Cloud Console won't display all the available backups for restoration.
Copy link
Collaborator

@juliamrch juliamrch Dec 3, 2024

Choose a reason for hiding this comment

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

Suggested change
If you have a custom backup configuration with multiple retention policies and periods, the Clever Cloud Console won't display all the available backups for restoration.
You can request custom backups configurations, with multiple retention policies and periods, by contacting the Support.The Clever Cloud Console won't display all the available backups for restoration, but you can find specific backups using [Clever Tools](https://github.com/CleverCloud/clever-tools), with the following command: `clever database backups DATABASE-ID [--format, -F] FORMAT`. Find more documentation on restoring backups with the CLI [here](https://github.com/CleverCloud/clever-tools/blob/master/docs/addons-backups.md#database-backups).

This way, even if one datacenter has an accident, your backup are still safe in two different datacenters.

If you have a custom backup configuration with multiple retention policies and periods, the Clever Cloud Console won't display all the available backups for restoration.
However, you can restore a specific backup using [Clever Tools](https://github.com/CleverCloud/clever-tools). This allows for greater flexibility in managing and restoring backups outside the standard Console interface.
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
However, you can restore a specific backup using [Clever Tools](https://github.com/CleverCloud/clever-tools). This allows for greater flexibility in managing and restoring backups outside the standard Console interface.
This allows for greater flexibility in managing and restoring backups outside the standard Console interface.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@aurrelhebert @draescherl
What do you think about this suggestion?

Copy link
Collaborator

@juliamrch juliamrch left a comment

Choose a reason for hiding this comment

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

Added suggestion to clarify the context and the command to find a specific backup.

@@ -213,5 +213,10 @@ If a VACUUM operation needs more disk that there is remaining, migrating to the
## Where are the backups stored?

Clever Cloud store all your backups on [Cellar](https://www.clever-cloud.com/product/cellar-object-storage/).
Copy link
Collaborator

Choose a reason for hiding this comment

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

Maybe we should explain here Cellar is an replicated object storage service, and then detail it's replication mechanism. Beware of new lines/paragraphs if not needed: maybe we should regroup sentences here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants