[Axiom-developer] Axiom docker image

[daly]

Docker is a "container technology". It allows Axiom images that should
"just run" without users having to install software. When a docker
container is built all of the required software is "inside the
container".

Microsoft, Apple, and the Linux distros all support docker images.
Currently the Microsoft and Apple versions use VirtualBox but both
companies plan to support native docker containers.

Rather than build a new image for each platform, docker provides a
cross-platform solution. Work is being done to automate the Axiom
build process, including automatically constructing and building
docker containers. This will provide a continuous build process which
makes the latest Axiom always available.

Axiom is now available in docker. Assuming you have docker installed:

  docker pull daly/axiom
  docker run -i -t daly/axiom axiom




You might run into a few issues if you have never used docker.

======================================================================
PROBLEM: DOCKER IS NOT INSTALLED

To install docker type

  apt-get update
  apt-get install docker.io (ubuntu)

  yum update
  yum install docker.io     (fedora)

======================================================================
PROBLEM: SILENCE ... THE OTHER DOCKER COMMAND

Note that there is an app named "docker" which is not the same thing.
You might have to remove it first due to name conflicts.

  sudo apt-get remove -y docker
  sudo apt-get install -y docker.io

======================================================================
PROBLEM: SOCKET ERROR MESSAGE

You might get an error message like:

  docker pull daly/axiom
  2014/12/22 11:19:38 Get http:///var/run/docker.sock/v1.15/info: dial unix

which means that the docker daemon is not running. To fix this type

  sudo systemctl start docker
  sudo systemctl enable docker

The first command starts the docker daemon. The second command 
enables docker to run when the system starts.

======================================================================
PROBLEM: USER LEVEL PERMISSION 

You might need to add yourself to the docker group and reboot

  sudo usermod -a -G docker (your username)
  sudo reboot

Now as a non-root user you should be able to do

  docker run -i -t daly/axiom axiom



Please let me know if you have any problems.

Tim