/docs/MyDocs

Terms

=====

 Docker is built around concept of layers which can be seen as delta updates.

 - There are multiple read-only layers forming the static image and a single

 writable layer on top of the image.

 - Image + writable layer is a Container, a running copy  of the image.

    - Actually, also plus environment and plus mounted volumes

    - The images may have a multiple associated containers (detached containers)

    - Each container can be saved to create a new image

 - The container data is persistented across runs, but can be easily reseted

 from the image. Additionally, the persistent volumes from host system can be 

 mapped into the container. 

    - This can be either existing host directory or auto-created mapping 

    associated with container.

    - Some of such mappings can be declared to hold temporary files during

    the 'docker run' state

 - Each command (event MAINTAINER) in docker file creates another layer. 

 This leads to layer poisoning and there is some limit to number of layers (127?)

    - For this reason, normally multiple RUN commands are combined

    - There are non-official squashing tools, but, then, all history is lost

        https://github.com/jwilder/docker-squash

 - Layers can be re-used by multiple containers. For this reason the proper

 composition is important. For instance:

        OpenSuSE -> mc -> adei

                       -> mysql

 - There is no defined way how to start a new image. Rather docker recomends

 to start of some exisiting docker image. 

    - OpenSuSE has Kiwi tool to build images (including docker ones) and it uses

    the tool to build official OpenSuSE docker images. However, it recommends to 

    branch of the official OpenSuSE images, rather than using the tool itself.

 

 Details:

    https://docs.docker.com/engine/userguide/storagedriver/imagesandcontainers/

 

Container Lify Cycle

--------------------

 - Create an container from the image

 - Start container 

 - Pause/Resume container

 - Stop container (auto-restart can be configured)

 - Optionally create a new image from the container

 - Delete container

 

 

Management

----------

 * Cron Jobs: Docker is designed to run a single application. There is a several ways to run cron in the container.

    - Trigger cron job from the host system using docker exec. This is in-optimal as it will break when we start using 

    orchestration and allow container migration between nodes of the cluster.

    - Run multiple services in container with 'supervisor' (python). Both cron and anacron seems required. Should

    work, but goes a bit against the base idea of docker.

    - Provide a minimal cron container which will trigger tasks in the main container with docker exec.

    

 * Monitoring

    - We can't directly see free space on the host volumes from inside the container