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

Docs: Enhance immutable snapshots guide with detailed instructions #811

Conversation

seshachalam-yv
Copy link
Contributor

What this PR does / why we need it:

This PR enhances the documentation for enabling immutable snapshots in etcd-backup-restore. It provides a comprehensive guide with detailed instructions for configuring bucket-level immutability on Google Cloud Storage (GCS) and Azure Blob Storage (ABS). The updated guide includes:

  • A Terminology section for clarity and consistent use of terms.
  • Detailed steps for configuring retention policies and locking them.

Which issue(s) this PR fixes:
Fixes #

Special notes for your reviewer:

  • The file docs/usage/immutable_snapshots.md has been revised and renamed to docs/usage/enabling_immutable_snapshots.md to better reflect its content.

cc: @renormalize @ishan16696

Release note:

Enhanced the documentation for enabling immutable snapshots in `etcd-backup-restore`, providing detailed guidance and best practices for configuring bucket-level immutability on Google Cloud Storage and Azure Blob Storage.

Revise 'enabling_immutable_snapshots.md' to provide a comprehensive guide on enabling immutable snapshots in `etcd-backup-restore`.

- Add a Terminology section for clarity and consistent use of terms.
- Include detailed instructions for configuring bucket-level immutability on Google Cloud Storage (GCS) and Azure Blob Storage (ABS).
- Elaborate on best practices.
- Improve grammar and readability throughout the document.
@seshachalam-yv seshachalam-yv requested a review from a team as a code owner December 3, 2024 03:51
@gardener-robot gardener-robot added needs/review Needs review size/l Size of pull request is large (see gardener-robot robot/bots/size.py) needs/second-opinion Needs second review by someone else labels Dec 3, 2024
@gardener-robot-ci-3 gardener-robot-ci-3 added the reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) label Dec 3, 2024
@gardener-robot-ci-2 gardener-robot-ci-2 added needs/ok-to-test Needs approval for testing (check PR in detail before setting this label because PR is run on CI/CD) and removed reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) labels Dec 3, 2024
@renormalize renormalize self-assigned this Dec 3, 2024
@renormalize renormalize added this to the v0.33.0 milestone Dec 3, 2024
Copy link
Member

@renormalize renormalize left a comment

Choose a reason for hiding this comment

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

Thank you very much for the documentation @seshachalam-yv!

docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
@gardener-robot gardener-robot added the needs/changes Needs (more) changes label Dec 3, 2024
- Changed 'Retention Period' to 'Immutability Period'.
- Removed reference to future AWS S3 support.
@gardener-robot-ci-1 gardener-robot-ci-1 added reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) and removed reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) labels Dec 3, 2024
@seshachalam-yv
Copy link
Contributor Author

Thanks @renormalize for reviewing. I've addressed all your review comments.

Copy link
Member

@renormalize renormalize left a comment

Choose a reason for hiding this comment

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

Thanks for the PR @seshachalam-yv!

I've pointed out one comment again which you'd missed. Other than that, the doc looks great.

docs/usage/enabling_immutable_snapshots.md Outdated Show resolved Hide resolved
@gardener-robot-ci-1 gardener-robot-ci-1 added the reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) label Dec 5, 2024
@gardener-robot-ci-2 gardener-robot-ci-2 removed the reviewed/ok-to-test Has approval for testing (check PR in detail before setting this label because PR is run on CI/CD) label Dec 5, 2024
@renormalize renormalize removed their assignment Dec 5, 2024
@seshachalam-yv seshachalam-yv merged commit b4d5705 into gardener:master Dec 5, 2024
9 checks passed
@seshachalam-yv seshachalam-yv deleted the docs/enhance-immutable-snapshots-guide branch December 5, 2024 11:04
@gardener-robot gardener-robot added the status/closed Issue is closed (either delivered or triaged) label Dec 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
needs/changes Needs (more) changes needs/ok-to-test Needs approval for testing (check PR in detail before setting this label because PR is run on CI/CD) needs/review Needs review needs/second-opinion Needs second review by someone else size/l Size of pull request is large (see gardener-robot robot/bots/size.py) status/closed Issue is closed (either delivered or triaged)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants