my_jupyterlab

Annotated docker image for running a Jupyter notebook with the MetPy library.

Minimum Requirements

• docker
• docker-compose

Recommended Requirements

• python 3.12+
• asdf
• poetry

Quickstart

Docker

# build the image
docker build -t metpy_test .

# run the container
docker run  -it --rm --name metpy_test -p 8888:8888 -v ~/metpy_test:/app metpy_test

Docker Compose

# build
docker compose build

# run the container
docker compose up

# build and run the container
docker compose up --build

# run the container in the background
docker compose up -d

# stop the container
docker compose stop

# remove the container and default bridge network
docker compose down

TODO

• Add asdf
• Add poetry
• Add .dockerignore
• Add hadolint and lint Dockerfile
• Add dive and reduce image size
• Migrate to alpine (along with musl libc changes)
• Create multistage build: Docker.multistage
• Add HTTPS
  • mkcert

    mkcert -key-file key.pem -cert-file cert.pem jupyter.local *.jupyter.local
    mkcert -install

  • LetsEncrypt
• Setup CI to auto publish to docker.io and ghcr.io registries