Ames Stereo Pipeline JupyterHub Image Builder

This repository has the configuration for a Jupyter-ready docker image with ASP pre-installed. It is intended to create a standard environment for users to easily experiment with ASP code. Analysis examples live in separate repostories:

Topic	Binder Link	Repository
ASTER DEM		Link

How to update the image

build with GitHub Actions simply by pushing to GitHub

• pull requests trigger image building without pushing to DockerHub
• commits to master branch (except readme.md changes) trigger re-building image
• successfully built image is tagged by github sha and 'latest' and pushed to DockerHub

git commit -a -m "modified binder/environment to my liking"
git push

Run a local JupyterLab session with the latest image

# map current directory to jupyterlab home directory
docker run -it --name ASP -p 8888:8888 -v $PWD:/home/jovyan uwcryo/asp-binder:latest jupyter lab --ip 0.0.0.0
docker stop ASP
docker rm ASP

Point to a specific tagged image in JupyterHub config

(uwcryo/asp-binder:b0db94de639a) https://zero-to-jupyterhub.readthedocs.io/en/latest/reference/reference.html?highlight=profile_list#singleuser-profilelist

Build locally

git clone https://github.com/uw-cryo/asp-binder.git 
cd asp-binder/binder
docker build -t uwcryo/asp-binder:test .