MCollective Docker Agent

This agent manages Docker containers and images.

To use this agent you need:

Agent Installation

By default the agent uses the unix socket /var/run/docker.sock to communicate with Docker. You can optionally change it in the server.cfg:

docker.url = unix:///var/run/docker.sock

List containers:

$ mco docker ps [-a]

List images:

$ mco docker ps [-a]

Start, stop, restart, pause, unpause, diff a container

$ mco docker <action> <container>

Kill a container:

$ mco docker kill [--signal <SIGNAL>] <container>

Remove a container:

$ mco docker rm [--force] <container>

Show the container logs:

$ mco docker logs <container>

Show the container status:

$ mco docker status <container>

Execute a command in the container:

$ mco docker exec <container> <command>

Inspect a container:

$ mco docker inspect --type container <container>

Show top processes running inside the container:

$ mco docker top <container>

Inspect an image:

$ mco docker inspect --type image <image>

Pull an image:

$ mco docker pull <image>

Remove an image:

$ mco docker rmi [--force] <image>

Tag an image:

$ mco docker tag <name>[:tag] [<repo>/]<name>[:tag]

The docker agent also supplies some data plugins. See the examples below:

Ping hosts where an image is present:

$ mco rpc rpcutil ping -S "docker_image('<ID>').exists=true"

Ping hosts where a container is present:

$ mco rpc rpcutil ping -S "docker_container('<ID>').exists=true"

Ping hosts where a container is running:

$ mco rpc rpcutil ping -S "docker_container('<ID>').running=true"

Ping hosts where a container is restarting:

$ mco rpc rpcutil ping -S "docker_container('<ID>').restarting=true"

Ping hosts where a container is paused:

$ mco rpc rpcutil ping -S "docker_container('<ID>').paused=true"

Ping hosts where a container is dead:

$ mco rpc rpcutil ping -S "docker_container('<ID>').dead=true"

Ping hosts where a container experienced OOM killing

$ mco rpc rpcutil ping -S "docker_container('<ID>').oomkilled=true"