Handle docker containers as services in RHEL.

Martin Hovmöller



9,819 latest version

2.5 quality score

Version information

  • 0.1.0 (latest)
released Oct 30th 2014
This version is compatible with:
  • RedHat

Start using this module


akegata/docker — version 0.1.0 Oct 30th 2014


Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with docker
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module
  8. Contact


Manage docker instances with hiera in RHEL/CentOS.

Module Description

Creates systemd or init services (depending on RHEL version) for containers specified in hiera.


What docker affects

On RHEL/CentOS 7, this module installs docker 1.3.0 from binary, since RHEL/CentOS 7 repos provide a very old docker version.

Beginning with docker

Install the docker module: puppet module install akegata-docker

Add the docker class in hiera: classes

  - docker


Set up docker containers in hiera: docker::container: apache: repository: 'akegata/apache2' envs:

      - 'APACHE_USER=apache'
      - '8080:80'
      - '/var/www/httpd:/var/www/httpd/'

The following parameters are available:

  • repository - Name of the repository on docker hub to use (mandatory)
  • envs - Environmental variables (optional)
  • ports - Ports to publish to the host (optional)
  • volumes - Volumes to bind mount (optional)
  • options - Other options to pass to docker run (optional)


Contains a single class: docker. A define called docker::container is created, which can be called through hiera as described in Usage.

On RHEL/CentOS 7, the module copies the following folders onto the system (they are taken from the CentOS 6.5 docker RPM):

  • /usr/bin/docker
  • /usr/lib/systemd/system/docker.service
  • /usr/lib/systemd/system/docker.socket
  • /etc/bash_completion.d/docker.bash
  • /usr/share/vim/vimfiles/syntax/dockerfile.vim
  • /usr/share/vim/vimfiles/ftdetect/dockerfile.vim
  • /usr/share/vim/vimfiles/doc/dockerfile.txt


Tested on puppet 3.7.1 with hiera 1.3.4 on CentOS 6 and 7.


Martin Hovmöller