[HWORKS-2731] Document HopsFS access path for shared datasets#569
Merged
gibchikafa merged 13 commits intologicalclocks:mainfrom Apr 30, 2026
Merged
[HWORKS-2731] Document HopsFS access path for shared datasets#569gibchikafa merged 13 commits intologicalclocks:mainfrom
gibchikafa merged 13 commits intologicalclocks:mainfrom
Conversation
Add the mounted shared-dataset path to the Accessing project data sections in the Python notebook, Ray notebook, Python job, notebook job, and Ray job guides. The new docs clarify that when HopsFS is mounted, shared datasets are available under /hopsfs/shared-datasets/<source-project>/<dataset-name>, alongside the existing examples for project-local datasets under /hopsfs.
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Hopsworks user guides to document the filesystem path for accessing shared datasets when HopsFS is mounted, complementing existing /hopsfs/<dataset>/... examples for project-local datasets.
Changes:
- Add shared-dataset mount path
/hopsfs/shared-datasets/<source-project>/<dataset-name>to notebook guides (Python, Ray). - Add the same shared-dataset mount path to job guides (Python, Notebook Job, Ray Job).
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/user_guides/projects/jupyter/ray_notebook.md | Documents the shared-dataset access path for Ray notebooks. |
| docs/user_guides/projects/jupyter/python_notebook.md | Documents the shared-dataset access path for Python notebooks. |
| docs/user_guides/projects/jobs/ray_job.md | Documents the shared-dataset access path for Ray jobs. |
| docs/user_guides/projects/jobs/python_job.md | Documents the shared-dataset access path for Python jobs. |
| docs/user_guides/projects/jobs/notebook_job.md | Documents the shared-dataset access path for notebook jobs. |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Extend the shared datasets guidance in notebook and job documentation to mention that the mounted shared datasets directory is also exposed through the SHARED_DATASETS_DIR environment variable.
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, project datasets are available under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>`. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
|
|
||
| The project datasets are mounted under `/hopsfs` in the Ray containers, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv`. | ||
| If HopsFS is mounted in the Ray containers, project datasets are available under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv`. | ||
| If HopsFS is mounted in the Ray containers, shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>`. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, project datasets are available under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>`. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, project datasets are available under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>`. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Contributor
Author
There was a problem hiding this comment.
@copilot apply changes based on this feedback
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, project datasets are available under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| If HopsFS is mounted, shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>`. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your notebook. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
| ### Absolute paths | ||
|
|
||
| The project datasets are mounted under `/hopsfs`, so you can access `data.csv` from the `Resources` dataset using `/hopsfs/Resources/data.csv` in your script. | ||
| Shared datasets are accessible at `/hopsfs/shared-datasets/<source-project>/<dataset-name>` if HopsFS is mounted. The shared datasets directory is also available through the `SHARED_DATASETS_DIR` environment variable. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Contributor
Author
|
@copilot apply changes based on the comments in this thread. Also commit all the changes. |
Contributor
Author
|
@copilot apply changes based on the comments in this thread |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
jimdowling
approved these changes
Apr 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add the mounted shared-dataset path to the Accessing project data sections in the Python notebook, Ray notebook, Python job, notebook job, and Ray job guides.
The new docs clarify that when HopsFS is mounted, shared datasets are available under /hopsfs/shared-datasets//, alongside the existing examples for project-local datasets under /hopsfs.