mediadesignpractices/debian repository overview

⁠MDP Dockerfiles

A few mdp oriented Dockerfiles for getting students up and running quickly.

Linux CPU

⁠What is Docker

Docker is an open-source program that enables a Linux application and its dependencies to be packaged as a container.

Container-based visualization isolates applications from each other on a shared operating system (OS). This approach standardizes application delivery, allowing apps to run in any Linux (or Mac) environment, whether physical or virtual. Because they share the same operating system, containers are portable among different Linux distributions and are significantly smaller than virtual machine (VM) images.

More importantnly it allows everyone who is working on an application (or workshop) to start with an identical setup.

⁠Installing Docker

General installation instructions are on the Docker site⁠, but here are some quick links:

• OSX⁠: docker toolbox⁠
• ubuntu⁠

⁠Repositiory Structure

The dockerfiles in this repository are structured so that they stack, starting at a base image, then core dependencies, up to higher level applications or libraries. Because of Docker's "Automated Builds" changes to base images automatically work their way in to images that have them as a dependency or starting point.

The structure:

buildpack-deps:jessie
|
|... mediadesignpractices/debian
    |
    |... mediadesignpractices/python(or python3)
    |   |... mediadesignpractices/jupyter(or jupyter-python3)
    |       |...mediadesignpractices (Natural Language Toolkit)
    |
    |...mediadesignpractices/node


tensorflow/tensorflow:latest-gpu
|
|... mediadesignpractices/tensorflow
    |... mediadesignpractices/keras

Because the majority of MDP students and faculty are prototyping rather than developing applications the images are MDP specific builds that are closer to working in a linux development environment with base tools like nano, vim, git, unzip, wget etc. which help with command line interaction, there are "official" images (which these are based on) that are bare bones and therefore less relevant for prototyping.

⁠Getting started

We are using Makefile to simplify docker commands within make commands. You can download⁠ the makefile from git.

# curl -O https://raw.githubusercontent.com/mediadesignpractices/docker/master/Makefile

Run the container and start a bash

$ make bash

⁠Tagging system

The repository follows semver⁠ format.

Because many of the images are related, all images (python, node, jupyter) share the same version numbers. They are not related to the application version python:v2.7.1 would not be python version python-v2.7.1.

If you are building something that requires stability make sure to use a versioned image e.g. mediadesignpractices/python:v1.0.1 rather than mediadesignpractices/python or mediadesignpractices/python:latest. The same goes for anything that is "archival".

⁠Contributing

Tag changes following semver format, adding a package to mediadesignpractices:latest would constitute a minor version change e.g. v1.0.1 becomes v1.0.2.

Changing node.js from v6.10.0 to v7.0.1 would probably constitute a major breaking version change, e.g. v1.0.1 becomes v2.0.0.

This is the regualar expression used to validate a release tag:

^[v]((\d?\d\.)(0\.|[1-9]?[0-9]\.)([1-9]?[0-9]|))$

You can try it on regex101⁠

To tag a change:

# add a tag
git tag {tag}

# Move a tag to current commit (for example you just changed the readme), use force.
git tag {tag} -f

# push the tags to github
git push origin {branch} --tags (-f to force)