Docker Community Collection

This repo contains the community.docker Ansible Collection. The collection includes many modules and plugins to work with Docker.

Tested with Ansible

Tested with the current Ansible 2.9 and 2.10 releases and the current development version of Ansible. Ansible versions before 2.9.10 are not supported.

External requirements

Most modules and plugins require the Docker SDK for Python. For Python 2.6 support, use the deprecated docker-py library instead.

Included content

• Connection plugins:
  • community.docker.docker
• Inventory plugins:
  • community.docker.docker_machine
  • community.docker.docker_swarm
• Modules:
  • community.docker.docker_compose
  • community.docker.docker_config
  • community.docker.docker_container_info
  • community.docker.docker_container
  • community.docker.docker_host_info
  • community.docker.docker_image_info
  • community.docker.docker_image
  • community.docker.docker_login
  • community.docker.docker_network_info
  • community.docker.docker_network
  • community.docker.docker_node_info
  • community.docker.docker_node
  • community.docker.docker_prune
  • community.docker.docker_secret
  • community.docker.docker_stack_info
  • community.docker.docker_stack
  • community.docker.docker_stack_task_info
  • community.docker.docker_swarm_info
  • community.docker.docker_swarm
  • community.docker.docker_swarm_service_info
  • community.docker.docker_swarm_service
  • community.docker.docker_volume_info
  • community.docker.docker_volume

Using this collection

Before using the General community collection, you need to install the collection with the ansible-galaxy CLI:

ansible-galaxy collection install community.docker

You can also include it in a requirements.yml file and install it via ansible-galaxy collection install -r requirements.yml using the format:

collections:
- name: community.docker

See Ansible Using collections for more details.

Contributing to this collection

If you want to develop new content for this collection or improve what is already here, the easiest way to work on the collection is to clone it into one of the configured COLLECTIONS_PATH, and work on it there.

You can find more information in the developer guide for collections, and in the Ansible Community Guide.

Release notes

See the changelog.

More information

• Ansible Collection overview
• Ansible User guide
• Ansible Developer guide
• Ansible Collections Checklist
• Ansible Community code of conduct
• The Bullhorn (the Ansible Contributor newsletter)
• Changes impacting Contributors

Licensing

GNU General Public License v3.0 or later.

See COPYING to see the full text.