utoronto-2i2c / jupyterhub-deploy

Demo JupyterHub deployment for University of Toronto
BSD 3-Clause "New" or "Revised" License
3 stars 4 forks source link

🔴 DEPRECATED - DO NOT USE THIS

UToronto hub is now deployed from ➡️ https://github.com/2i2c-org/infrastructure

2i2c JupyterHub for University of Toronto

Check it out at jupyter.utoronto.ca

Pulling from private GitHub repos with nbgitpuller

GitHub is used to store class materials (lab notebooks, lecture notebooks, etc), and nbgitpuller is used to distribute it to students. By default, nbgitpuller only supports public GitHub repositories. However, University of Toronto JupyterHub is set up to allow pulling from private repositories as well.

Public repositories are still preferred, but if you want to distribute a private repository to your students, you can do so by adding installing this GitHub app in your private repository.

  1. Go to the University of Toronto JupyterHub Private Repo Access

  2. Click the 'Install' button.

  3. Select the organization / user containing the private repository you want to distribute on the JupyterHub. If you are not the owner or administrator of this organization, you might need extra permissions to do this action.

  4. Select 'Only select repositories', and below that select the private repositories you want to distribute to this JupyterHub.

  5. Click the 'Install' button. The University of Toronto JupyterHub now has access to this repo. You can revoke this anytime by coming back to this page, and removing the repo from the list of allowed repos. You can also totally uninstall the GitHub app.

  6. You can now make a link for your repo at nbgitpuller.link. If you had just created your repo, you might have to specify main instead of master for the branch name, since GitHub changed the name of the default branch recently.

That's it! You're all set. You can distribute these links to your students, and they'll be able to access your materials on jupyter.utoronto.ca after authenticating.

Note: Everyone on the University of Toronto JupyterHub can use nbgitpuller to clone your private repo if you do this. They won't be able to see that this repo exists, but if they get their hands on your nbgitpuller link they can fetch that too. More fine-grained permissions coming soon.