Skip to content

Latest commit

 

History

History
45 lines (34 loc) · 2.19 KB

README.md

File metadata and controls

45 lines (34 loc) · 2.19 KB
Raw

Ames Stereo Pipeline JupyterHub Image Builder

Action Status Docker Pulls DockerHub Version Binder

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 Binder 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 .