Littlest jupyterhub| 02 using nbgitpuller to distribute shared files

Want to make APP Same thing as WeChat , Can run small programs smoothly ？ | Experience will send you to Xinjiang 、 Huawei 、 Cherry keyboard ！>>>

In the use of JupyterHub when , A common requirement is to give users / Students distribute data and sample code , Generally speaking, we want to make students / Users can ：

1. Easy access to the latest version of experimental data and code
2. Don't worry about losing your homework , Even if the teacher changes the content , It doesn't cover the students' changes
3. There is no need to manually handle merge conflicts or other complex operations

Corresponding , managers / Teachers should ：

1. Use modern collaborative version control tools to write and store instructional materials , at present Git It's the best tool

nbgitpuller  It's a Jupyter Notebook Expand , Can help achieve the above functions

This tutorial will guide you in creating a magic nbgitpuller link , bring JupyterHub Of users can click on the link , Directly from the designated git repository For the latest version of the material

• 00 Pre configuration requirements

  • Use  Littlest JupyterHub Installed JupyterHub

  • It needs to be distributed git Warehouse

• 01 Generate a nbgitpuller link

    Use a based on Binder The application of the link is generated online , The operation steps are: ：

    1、 Open the link mybinder.org based application, Wait for the application to compile

 

    2、 Enter the relevant information in the blank box

        branch： What to pull git The branch of the project

        hub_url： Own server Jupyter Hub Of url

        repo_url： What to pull git Project url

        urlpath： Need from git In the project Pull the file route

    When you're done typing , You can see a link generated below , By clicking on the link, users can distribute the project to their respective environments

    3、 Manually edit sharing links , The link is organized as ：

http://<my-jhub-address>/hub/user-redirect/git-pull?repo=<your-repo-url>&branch=<your-branch-name>&subPath=<subPath>&app=<notebook | lab>

    repo：git Links to projects

    branch： The branch of the project , The default is master

    subPath： The directory within the project to be launched after cloning / The path of the notebook . The default is to open the link Git The root directory of the warehouse

    app：  Choose which application view to open （Jupyter Notebook/ Jupyter Lab） This parameter is optional , The default is environment variable NBGITPULLER_APP Value , If there is no definition , The default is Notebook

    urlPath： If you specify urlPath,app and subPath Will be covered , And redirect to the specified path .

    thus , Distribution links are made , This link can be shared with users in various ways / Students ！

• 02 The user clicks on the link

    1、 When the user clicks on the link and logs in Jupyter Hub after , You can see the progress bar as shown in the figure below , At this time, remote pull and merge operations are being performed automatically

    2、 Final , Users enter their own environment , You can see that the project has been placed in the file directory ！

    

 

    The next section is about nbgitpuller Specific characteristics of ：）

 

Reference link ：

https://tljh.jupyter.org/en/latest/howto/content/nbgitpuller.html

https://github.com/jupyterhub/nbgitpuller#constructing-the-nbgitpuller-url