luzifer / dockermanager
The intention of this project is to have a running daemon on a docker host server which is able to realize a configuration of docker containers. For this it manages all containers and images on the docker host. This includes starting and stopping containers which are or are not defined by the configuration file.
- One or more host servers with latest docker-ce / docker-ee
- A config file or config URL to serve the configuration from
- Docker daemon listening on tcp port
- The dockermanager set up
- If you want to use images from a private registry put a
docker login) to the homedir of the user running dockermanager
Wasn't this supposed to be a cluster manager?
Yeah, speaking of pre-1.0 versions this is true. In the early development the dockermanager was intended to use a serf cluster to manage a whole cluster of machines. Because I never had the need to manage a cluster on my private projects I never really worked on the cluster logic.
In the meantime a bunch of cluster managers / schedulers having the capability to run Docker containers emerged and therefore I decided to cut out the cluster functionality. Following the principle "do one thing and do it well" the dockermanager now concentrates on managing single machines.
I'm managing a handfull of servers running as single nodes and that's where I'm optimizing the dockermanager. If you are searching for a solution to manage a cluster of machines you might want to take a look at these ones:
- Amazon ECS (Running Docker containers on a cluster of EC2s)
- Hashicorp Nomad (Full cluster solution including ability to run Docker containers)
- Kubernetes (Automated container deployment, scaling, and management)
- Mesosphere DC/OS (OS built around containers and services)
# ./dockermanager --help Usage of ./dockermanager: -c, --config string Config file or URL to read the config from (default "config.yaml") --configInterval int Sleep time in minutes to wait between config reloads (default 10) --docker-certs string Directory containing cert.pem, key.pem, ca.pem for the registry --docker-host string Connection method to the docker server (default "unix:///var/run/docker.sock") --fullHost Manage all containers on host (default true) --log-level string Set log level (debug, info, warning, error) (default "info") --refreshInterval int fetch new images every <N> minutes (default 30)
The configuration is written in YAML format and reloaded regularly by the daemon:
container-name: Name of the container on the host. Needs to be unique
command: Override CMD value set by Dockerfile
hosts: Array of hostnames to deploy the container to or
image: Name of the image
tag: Tag for the image, probably
links: Links to other containers in format
volumes: Volume mapping in form
ports: Array of port configurations
container: Exported port in the container e.g.
local: IP/port combination in the form
environment: Array of environment variables in form
update_times: Array of allowed time frames for updates of this container in format
HH:MM-HH:MM(Optional, if not specified container is allowed to get updated all the time.)
start_times: Cron-style time specification when to start this container. Pay attention to choose a container quitting before your specified interval for this. Containers having this specification will not get started by default and are not restarted after they quit. Use this for starting cron-like tasks.
stop_timeout: Time in seconds to wait when stopping a deprecated container to be exchanged. (default: 5s)
labels: Labels to attach to the container
add_cap: Array of capabilities to add to this container
depends_on: Array of container names to start before this one
Example configuration for a jenkins container:
--- jenkins: hosts: - docker01 image: luzifer/jenkins tag: latest links: - "othercontainername:alias" volumes: - "/home/ubuntu/data/jenkins_home:/var/jenkins_home" ports: - container: 8080/tcp local: 0.0.0.0:1000 environment: - MYVAR=value update_times: - 04:00-06:00 stop_timeout: 20 scheduletest: hosts: - docker01 image: jlekie/curl tag: latest command: - "http://example.com/page" start_times: "*/2 * * * *"