hippogrief/pobsync
1
0
Fork 0
Code Issues 21 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

issue-6-restore-story #17

Merged
parkel merged 2 commits from issue-6-restore-story into master 2026-05-21 02:06:23 +02:00
Conversation 0 Commits 2 Files Changed 4 +129
parkel commented 2026-05-21 02:06:17 +02:00
Owner
Copy Link

Document and surface the manual restore story

This PR makes the pobsync 1.0 restore workflow explicit without adding
automatic restore execution.

Highlights:

  • Adds README guidance for manual restores from snapshot data directories.
  • Shows snapshot-specific restore commands on snapshot detail pages.
  • Includes rsync dry-run, staging restore, remote restore dry-run, directory restore, and single-file restore examples.
  • Explains that snapshots may contain hardlinks and should be treated as read-only.
  • Keeps restore execution manual until the restore story is proven and safe.

Tests:

  • docker compose run --rm web python manage.py test pobsync_backend.tests.test_views.ViewTests.test_snapshot_detail_renders_metadata_runs_and_children -v 2
  • docker compose run --rm web python manage.py test pobsync_backend -v 2
  • Latest full run: 166 tests, OK

Closes #6

Document and surface the manual restore story This PR makes the pobsync 1.0 restore workflow explicit without adding automatic restore execution. Highlights: - Adds README guidance for manual restores from snapshot data directories. - Shows snapshot-specific restore commands on snapshot detail pages. - Includes rsync dry-run, staging restore, remote restore dry-run, directory restore, and single-file restore examples. - Explains that snapshots may contain hardlinks and should be treated as read-only. - Keeps restore execution manual until the restore story is proven and safe. Tests: - docker compose run --rm web python manage.py test pobsync_backend.tests.test_views.ViewTests.test_snapshot_detail_renders_metadata_runs_and_children -v 2 - docker compose run --rm web python manage.py test pobsync_backend -v 2 - Latest full run: 166 tests, OK Closes #6
parkel added 2 commits 2026-05-21 02:06:17 +02:00
(docs) Add manual restore guidance for snapshots b78f102e9d 
Document the manual restore workflow in the README and surface snapshot-
specific restore commands on the snapshot detail page.

The guidance keeps restores intentionally manual for now: inspect the
snapshot data directory, run rsync with --dry-run, restore to staging
first, and treat hardlinked snapshot files as read-only.
(docs) Add targeted restore examples 20a9f93378 
Extend the restore guidance with directory and single-file dry-run
examples so operators can restore a focused path without copying an
entire snapshot.

Render the examples on snapshot detail pages using the selected
snapshot's data path and the host-specific staging destination.
parkel merged commit 2d9f453767 into master 2026-05-21 02:06:23 +02:00
parkel deleted branch issue-6-restore-story 2026-05-21 02:06:23 +02:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
area: future
Longer-term product direction.
 area: observability
Metrics, history, and capacity insights.
 area: policy
Backup policies, templates, and automation.
 area: restore
Restore and recovery workflows.
 area: security
Permissions, audit, and security hardening.
 bugfix
Bug fixes and correctness work.
 docs
Documentation and operator guidance.
 feature
New functionality.
 refactor
Internal restructuring without direct behavior changes.
 release
Release preparation and publishing.
 security
Security, permissions, and audit work.
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
parkel
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hippogrief/pobsync#17
Delete Branch "issue-6-restore-story"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?