Skip to content

Update docs.json - #746

Open
lavanya-gunreddi wants to merge 20 commits into
mainfrom
lg-global-store-477
Open

Update docs.json#746
lavanya-gunreddi wants to merge 20 commits into
mainfrom
lg-global-store-477

Conversation

@lavanya-gunreddi

Copy link
Copy Markdown
Contributor

No description provided.

@mintlify

mintlify Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🔴 Failed Jul 29, 2026, 3:55 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread storage/globalstore.mdx Outdated

## Limitations

Global volumes use object-backed storage, not a POSIX file system. Review the following before using global volumes in production.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

not a POSIX file system -> not a fully POSIX compliant file system

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — updated to "not a fully POSIX compliant file system." Pushed to this branch in commit 4053e32.

Comment thread storage/globalstore.mdx Outdated
Global volumes use object-backed storage, not a POSIX file system. Review the following before using global volumes in production.

- **Not suitable for training writes:** Writing large volumes of data such as checkpoints, logs, and activations to a global volume during training is not supported. Use a network volume for workloads that write frequently.
- **No POSIX semantics:** Global volumes do not support file locking, atomic rename, or hard links. Applications that depend on POSIX behavior may fail or produce unexpected results.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No POSIX semantics
-> Limited POSIX semantics

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless Apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — the label now reads "Limited POSIX semantics." Pushed to this branch in commit 4053e32.

Comment thread storage/globalstore.mdx Outdated
- **Not suitable for training writes:** Writing large volumes of data such as checkpoints, logs, and activations to a global volume during training is not supported. Use a network volume for workloads that write frequently.
- **No POSIX semantics:** Global volumes do not support file locking, atomic rename, or hard links. Applications that depend on POSIX behavior may fail or produce unexpected results.
- **No concurrent writes across Pods:** Multiple Pods writing to the same global volume concurrently can cause data corruption or overwrite conflicts. Use a network volume for shared mutable storage.
- **Object consistency:** Reads reflect the state of the volume at mount time. Updates made to the volume after the Pod starts may not be immediately visible inside the container.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Object consistency -> "Eventual consistency"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — the label now reads "Eventual consistency." Pushed to this branch in commit 4053e32.

@promptless

promptless Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

On it — applying the requested wording changes to storage/globalstore.mdx on this branch now. I'll follow up here once the updates are pushed.

@promptless

promptless Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Confirmed the wording against the file and I'm applying the requested edits to the "Limitations" section of storage/globalstore.mdx now. I'll follow up here once they're pushed.

- Reword POSIX file system phrasing to 'not a fully POSIX compliant file system'
- Relabel 'No POSIX semantics' as 'Limited POSIX semantics'
- Relabel 'Object consistency' as 'Eventual consistency'

Applies inline review suggestions from murat-runpod on PR #746.

@murat-runpod murat-runpod left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Just need to update /workspace -> /workspace-global in 3 places, other than that looks good!

Comment thread storage/globalstore.mdx Outdated
5. Click the volume dropdown and select your volume from the **Global volumes** section.
6. Click **Deploy Pod**.

The volume mounts at `/workspace` inside the container.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Should be: /workspace-global

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — updated to /workspace-global in commit 5082c66, pushed to this branch.

Comment thread storage/globalstore.mdx Outdated
Once the Pod is running, your files are available at `/workspace`. You can verify this from the Pod's **Console** tab:

```bash
ls /workspace

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

same here, /workspace-global

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — the ls command now uses /workspace-global in commit 5082c66, pushed to this branch.

Comment thread storage/globalstore.mdx Outdated

## Access your files

Once the Pod is running, your files are available at `/workspace`. You can verify this from the Pod's **Console** tab:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

and here: /workspace-global

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@Promptless Apply this comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Done — updated to /workspace-global in commit 5082c66, pushed to this branch.

Apply reviewer suggestions (murat-runpod) on PR #746: global volumes
mount at /workspace-global, not the default Pod /workspace path.
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