Use Ansible

Estimated reading time: 1 minute

Note: Please note this is a community contributed installation path.

Requirements

To use this guide you’ll need a working installation of Ansible version 2.1.0 or later.

Requirements on the host that will execute the module:

python >= 2.6
docker-py >= 1.7.0
Docker API >= 1.20

Installation

The docker_container module is a core module, and will ship with Ansible by default.

Usage

Task example that pulls the latest version of the nginx image and runs a container. Bind address and ports are in the example defined as a variable.

---
- name: nginx container
  docker:
    name: nginx
    image: nginx
    state: reloaded
    ports:
    - "::"
    cap_drop: all
    cap_add:
      - setgid
      - setuid
    pull: always
    restart_policy: on-failure
    restart_policy_retry: 3
    volumes:
      - /some/nginx.conf:/etc/nginx/nginx.conf:ro
  tags:
    - docker_container
    - nginx
...

Documentation

The documentation for the ansible_container module is present at docs.ansible.com.

Documentation covering Docker images, networks and services is also present at docs.ansible.com.

chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support