List of what is in the stable docker image

[mmoelter]

On this page (or similar)

http://fenics-containers.readthedocs.io/en/latest/images.html

it might be helpful to list everything in the stable image (along with version numbers).

For example, I assume that python is in there (but which version 2.7, 3.x?). Also, for users of the Jupyter notebook it would be good to document that numpy and matplotlib are also there and which versions.

[Jack Hale]

We do quite tightly control a lot of what we would consider to be 'important' versions in:

https://bitbucket.org/fenics-project/docker/src/7780f60830da5e191e2c766ca3f95d81b019604b/dockerfiles/dev-env-base/Dockerfile?at=master&fileviewer=file-view-default

These variables are available both inside a containers environment (run env) and can be inspected using Docker's image introspection abilities, i.e. without instantiating. FENICS_PYTHON_MAJOR_VERSION, FENICS_PYTHON_MINOR_VERSION, PETSC_VERSION etc. I don't want to hard-core documentation for these things as they will be inconsistent between image builds. But if you have a hash of an image, and the knowledge on how to do introspection on the container/image, you have the information you need.

Some things, Jupyter, matplotlib, iPython we just let it roll with the stable releases upstream using pip. You can find out about these in a running container using for example yolk -l which you can get with pip install yolk.

[Prof Garth Wells]

This would be a maintenance nightmare and would inevitably end up being inconsistent (as happened with the old buidlbot)

The Dockerfiles are the reference for what's in the containers.

[Jack Hale]

A clarification on the image introspection abilities:

docker inspect quay.io/fenicsproject/stable

Can grab out information very flexibly using -f flag:

docker inspect -f '{{ .Config.Env }}' quay.io/fenicsproject/stable