Home

Welcome to the PVSC48-Python-Tutorial wiki!

Introduction

These wiki pages are used to explain how to run the tutorial, set up the infrastructure, and other meta topics. For information on the tutorial itself, please consult the README

Set up the domain

The domain is hosted at Freenom. After logging in with the appropriate credentials, click Services from the navbar and select My Domains from the drop down menu. Form the My DOmains page find pvsc-python-tutorial.ml and click the Manage Domain button with a little gear. On the manage domains page, select the Manage Freenom DNS tab. In the first table that says Manage Records change both Targets to the IP addresses from Azure. Finally click Save Changes and wait a few minutes. It may take several minutes for the domain to begin routing to the new IP address so be patient.

Links with nbgitpuller

To start the tutorial with the very latest changes in this repository requires a link constructed with nbgitpuller which pulls the changes to each student's JupyterHub instance before opening the tutorial. This must be done by each student individually. The details are explained in the TLJH documentation. The link for this tutorial is as follows:

https://pvsc-python-tutorial.ml/hub/user-redirect/git-pull?repo=https://github.com/mikofski/PVSC48-Python-Tutorial&branch=main

See nbgitpuller docs for all options.

TLJH setup

This tutorial uses The Littlest JupyterHub and follows the Azure how to setup.

TLS/HTTPS

Follow the instructions in the TLJH docs to create a certificate with Let's Encrypt for your site.

Sharing data

The TLJH docs explain how to use nbgitpuller and set up a scratch folder and a shared folder for each user. The scratch folder lets students create scratch work to share with others. The shared folder has readonly data for everytone.