Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/source/getting_started/_static/storage_options_diagram.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 13 additions & 7 deletions docs/source/getting_started/getting_started.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -136,21 +136,22 @@
"\n",
"#### My root folder (fast cloud storage)\n",
" - Your Jupyter home directory (`~`) is mounted to `/projects`. Files in here persist across sessions and exist across your workspaces.\n",
" - Use this for code-related items, smaller data storage\n",
" - Git is more likely to behave predictably here compared to other storage\n",
" - Use this for code-related items, smaller data storage (such as Jupyter Notebooks, Python/ R/ Markdown files, etc.)\n",
" - Git is more likely to behave predictably here compared to other storage \n",
" - This is also the place to make persistent conda environments (covered in another section), but make sure to not make a conda env inside a git-tracked folder, or if you do add it to the .gitignore. If git is tracking an env, it could cause your workspace to crash. \n",
" - Uses local (to Jupyter) file system; generally faster and more reliable for “normal” file operations, but expensive\n",
"\n",
"#### Large file storage: my-private-bucket\n",
"`~/my-private-bucket` is an S3 bucket with persistent storage, but accessible only to you and others in a shared workspace.\n",
" \n",
" - Use for large data storage\n",
" - It will be slower than the root folder to copy and move files, which is why it is not ideal for storing smaller files that need to be read or written quickly\n",
" - It will be slower than the root folder to copy and move files, which is why it is not ideal for storing smaller files that need to be read or written quickly (e.g. Jupyter Notebooks)\n",
"\n",
"#### Sharing files: my-public-bucket and shared-buckets\n",
"`~/my-public-bucket` is an S3 bucket with persistent storage. It is the same as `~/shared-buckets/<my_username>/` — anything you put in here will be accessible to other users via `~/shared-buckets/<my_username>` as a read-only file. Likewise, to find shared files from another user, look in `~/shared-buckets/<their_username>`.\n",
"\n",
" - Use for large data storage for files that you want to share across workspaces\n",
" - Use for large data storage for files that you want to share across workspaces \n",
" - Public and shared buckets are not recommended for Jupyter Notebooks\n",
"\n",
"![Storage options diagram](_static/storage_options_diagram.png)\n",
"\n",
Expand All @@ -161,9 +162,9 @@
],
"metadata": {
"kernelspec": {
"display_name": "Python [conda env:root] *",
"display_name": "Python 3.12.0 64-bit",
"language": "python",
"name": "conda-root-py"
"name": "python3"
},
"language_info": {
"codemirror_mode": {
Expand All @@ -175,12 +176,17 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.7.8"
"version": "3.12.0"
},
"metadata": {
"interpreter": {
"hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
}
},
"vscode": {
"interpreter": {
"hash": "7500c3e1c7c786e4ba1e4b4eb7588219b4e35d5153674f92eb3a82672b534f6e"
}
}
},
"nbformat": 4,
Expand Down