Skip to content

docs: added layout descriptions#1314

Open
sushant-suse wants to merge 3 commits intolonghorn:masterfrom
sushant-suse:issue#8080-add-layout-desc
Open

docs: added layout descriptions#1314
sushant-suse wants to merge 3 commits intolonghorn:masterfrom
sushant-suse:issue#8080-add-layout-desc

Conversation

@sushant-suse
Copy link
Copy Markdown
Contributor

Which issue(s) this PR fixes:

Issue 8080

What this PR does / why we need it:

This PR adds detailed technical documentation regarding the internal data structures of Longhorn Replicas and Backupstores. Currently, while Longhorn provides high-level operational guides, there is a lack of documentation explaining how data is physically organized on the host disk and in remote backup targets. This information is essential for:

  • Developers who need to understand the relationship between metadata files (volume.meta, .img.meta) and the snapshot chain.
  • Users/Administrators who need to understand how content-addressable storage and 2MB block deduplication work in the backupstore for troubleshooting or storage auditing.

Special notes for your reviewer:

N/A

Additional documentation or context:

N/A

@netlify
Copy link
Copy Markdown

netlify Bot commented Feb 13, 2026

Deploy Preview for longhornio ready!

Name Link
🔨 Latest commit 71d371b
🔍 Latest deploy log https://app.netlify.com/projects/longhornio/deploys/69ca1680ece950000815d0b2
😎 Deploy Preview https://deploy-preview-1314--longhornio.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@derekbit derekbit force-pushed the issue#8080-add-layout-desc branch from bd1c96e to 6b3df45 Compare March 12, 2026 16:17
Copy link
Copy Markdown
Member

@derekbit derekbit left a comment

Choose a reason for hiding this comment

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

@sushant-suse There are some mistakes in the layout and description. Please set up a Longhorn cluster and nfs/minio server to execute backups to check the correct layout.

Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/replica-directory-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
Comment thread content/docs/1.12.0/internal-data-structure/backupstore-layout.md Outdated
@sushant-suse sushant-suse force-pushed the issue#8080-add-layout-desc branch from 6b3df45 to 6642fa4 Compare March 18, 2026 15:33
@sushant-suse sushant-suse requested a review from derekbit March 18, 2026 15:33
Signed-off-by: sushant-suse <sushant.gaurav@suse.com>
Signed-off-by: sushant-suse <sushant.gaurav@suse.com>
Signed-off-by: sushant-suse <sushant.gaurav@suse.com>
@derekbit derekbit force-pushed the issue#8080-add-layout-desc branch from 6642fa4 to 71d371b Compare March 30, 2026 06:21
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.

2 participants