Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update Jupyter Readme for notebook sharing #31

Conversation

tlvu
Copy link
Collaborator

@tlvu tlvu commented Sep 14, 2021

Explain the new mypublic and public folder (PR bird-house/birdhouse-deploy#190).

Show /notebook_dir/ is the notebook root (issue Ouranosinc/pavics-sdi#227).

What is not shown but will be effective is I've moved this file that is originally at https://github.com/bird-house/birdhouse-deploy/blob/537f997a1a9a57901b5072cc6c6f950f92f37e9a/docs/source/notebooks/README.ipynb to this repo since this file is fairly Ouranos specific and has some overlapping info with the landing homepage (PR #32).

I am setting up so we can harmonize this README.ipynb better with the landing homepage in the future.

Deployment of this README file is handled by PR bird-house/birdhouse-deploy-ouranos#15.

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

tlvu added a commit to bird-house/birdhouse-deploy-ouranos that referenced this pull request Sep 14, 2021
Match PR Ouranosinc/PAVICS-landing#31 that moved
the README.ipynb file outside of birdhouse-deploy repo.
content/jupyter-readme/README.ipynb Outdated Show resolved Hide resolved
Co-authored-by: David Huard <huard.david@ouranos.ca>
tlvu added a commit to bird-house/birdhouse-deploy that referenced this pull request Sep 15, 2021
This repo is intended to be generic.

That README.ipynb is moved to PR Ouranosinc/PAVICS-landing#31.
tlvu added a commit to bird-house/birdhouse-deploy that referenced this pull request Sep 15, 2021
This repo is intended to be generic.

That README.ipynb file is moved to PR Ouranosinc/PAVICS-landing#31.

The deployment part is moved to PR bird-house/birdhouse-deploy-ouranos#15.
@tlvu tlvu merged commit 92170d8 into migrate-pavics-jupyter-readme-from-birdhouse-deploy-repo Sep 15, 2021
@tlvu tlvu deleted the update-jupyter-readme-for-notebook-sharing branch September 15, 2021 14:59
tlvu added a commit that referenced this pull request Sep 15, 2021
…from-birdhouse-deploy-repo

Migrate pavics jupyter readme from birdhouse deploy repo

See PR #31.
tlvu added a commit to bird-house/birdhouse-deploy-ouranos that referenced this pull request Sep 15, 2021
deploy pavics-landing: add Jupyter env Readme deployment

Match PR Ouranosinc/PAVICS-landing#31 that moved the `README.ipynb` file outside of birdhouse-deploy repo.

Match PR bird-house/birdhouse-deploy#190 that deleted the deployment of `README.ipynb` at the old location.
tlvu added a commit to bird-house/birdhouse-deploy that referenced this pull request Sep 20, 2021
…yter

jupyter: sample code for simple and naive notebook sharing between users and README file relocation and deployment change

## Overview

*  **Backward-incompatible change**: do not, by default, volume-mount the Jupyter env README file since that file has been deleted in this repo.  That file is fairly specific to Ouranos while we want this repo to be generic.  PR Ouranosinc/PAVICS-landing#31 restored that file in PAVICS-landing repo that is Ouranos specific.
    * Previous default added as a comment in `env.local` for existing deployment to restore the previous behavior.  Although the README file has been deleted in this PR, it has already been previously deployed so existing system can restore the previous behavior of having the existing README file.  This file will simply be not updated anymore.

* Delete the deployment of that README file as well since that README file is deleted. PR bird-house/birdhouse-deploy-ouranos#15 restore the deployment for Ouranos.

* Each Org will be responsible for the deployment of their own README file.  PR bird-house/birdhouse-deploy-ouranos#15 can be used as a working example from Ouranos.

* Add sample code for simple and naive notebook sharing between Jupyter users.

## Notebook sharing details

Shared notebooks will be visible to all users logged in, even the public demo user so do not share any notebooks containing sensitive private info.

Can not share to a specific user.

Anyone will see the login id of everyone else so if the login id needs to be kept private, change this sample code.

Inside Jupyter, user will have the following additional folders:

```
.
├── mypublic/  # writable by current user
│   ├── current-user-public-share-file.ipynb
│   ├── (...)
├── public/  # read-only for everyone
│   ├── loginid-1-public/
│   │   └── loginid-1-shared-file.ipynb
│   │   └── (...)
│   ├── loginid-2-public/
│   │   └── loginid-2-shared-file.ipynb
│   │   └── (...)
│   ├── (...)-public/
│   │   └── (...)
```

User can drop their files to be shared under folder `mypublic` and see other users share under `public/{other-loginid}-public`.

Matching PR Ouranosinc/PAVICS-landing#31 updating README inside the Jupyter env to explain this new sharing mechanism.

Deployed to https://medus.ouranos.ca/jupyter/ for acceptance testing.
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.

None yet

3 participants