Note: Please note this is a community contributed installation path.
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
docker_container module is a core module, and will ship with
Ansible by default.
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 ...
The documentation for the
ansible_container module is present at
Documentation covering Docker images, networks and services is also present at docs.ansible.com.