Skip to content

Latest commit

 

History

History
49 lines (31 loc) · 3.09 KB

README.md

File metadata and controls

49 lines (31 loc) · 3.09 KB

Euroargodev software environments for Binder service

This repo is here to de-couple the content of your euroargodev repository from the environment that is needed to run it on Binder.

This repo allows to:

  1. avoid the pain of setting up a customised Binder on your repo (use this repo branches instead)
  2. speed up Binder launch from your repo (de-couple content from environment)

To generate your own "Open with Binder" links and badges, please check: https://euroargodev.github.io/binder-links-creator/

Examples

Binder

Binder

If you still want to set-up Binder in your own repo, just use this one as a template by clicking here !

Environments

Euroargodev Binder jupyterhub instances are created using the following Pangeo docker images:

branch Pangeo image Euroargodev additional packages
main pangeo/pangeo-notebook:latest cmocean
pangeo-ml pangeo/ml-notebook:latest cmocean
virtual-fleet pangeo/pangeo-notebook:latest cmocean, pyxpcm, parcels, cgen, pymbolic, progressbar,

Note that all Pangeo images come with argopy installed.

How to customise an environment for a project ?

The simple way: simply raise an issue to ask for a missing package !

The more complex way:

  • fork this repo,
  • select the branch you want to update, or create a new one,
  • make your changes in the Dockerfile and README.md files,
  • make a PR.

More resources:

List of Pangeo images: https://hub.docker.com/u/pangeo

Source code for Pangeo images: https://github.com/pangeo-data/pangeo-docker-images

More on Pangeo cloud software environments: https://pangeo.io/cloud#software-environment

How to customise Binder build: https://repo2docker.readthedocs.io/en/latest/config_files.html

More on Dockerfile used by Binder: https://mybinder.readthedocs.io/en/latest/tutorials/dockerfile.html