community.docker 5.1.0 — New Feature for Docker Compose Pull

community.docker 5.1.0 Release

The community.docker 5.1.0 Ansible collection has been released with a new feature for the docker_compose_v2_pull module.

See also: Ansible Docker Compose: Manage Multi-Container Stacks (Guide)

What's New

• New feature for the docker_compose_v2_pull module, enhancing Docker Compose integration with Ansible

How to Install or Upgrade

ansible-galaxy collection install community.docker:==5.1.0 --upgrade

Or add to your requirements.yml:

collections:
  - name: community.docker
    version: ">=5.1.0"

See also: Ansible Docker: Complete Guide to Container Automation (2026)

About community.docker

The community.docker collection provides modules and plugins for managing Docker containers, images, networks, and volumes with Ansible. Key modules include: • docker_container — Manage containers • docker_image — Build and manage images • docker_compose_v2 — Manage Docker Compose projects • docker_network — Manage Docker networks • docker_volume — Manage Docker volumes

Resources

• Changelog • Galaxy Page • Ansible Forum

See also: Ansible docker_container Module: Manage Docker Containers (Guide)

How to Verify the Install

After installing or upgrading the collection, confirm the version is what you expect:

ansible-galaxy collection list community.docker
ansible-galaxy collection verify community.docker:5.1.0

Expected output:

Collection         Version
------------------ -------
community.docker   5.1.0

If you maintain a requirements.yml, pin the version explicitly so CI runs are reproducible:

collections:
  - name: community.docker
    version: "5.1.0"

Then install with ansible-galaxy collection install -r requirements.yml --force.

Module Discovery

List every module shipped by the collection and read the inline docs:

ansible-doc -l community.docker
ansible-doc community.docker.<module_name>

Use ansible-doc -t plugin_type community.docker to enumerate filter, lookup, callback, inventory, and other plugin types beyond modules.

Best Practices for Production Use

• Pin the collection version in requirements.yml — never rely on "latest" in a CI pipeline. Patch releases can change behavior even when SemVer says they should not. • Run ansible-galaxy collection verify in CI to detect tampering / corrupted tarballs. • Build an Execution Environment with the pinned collection so the same artifacts run in dev, staging, and prod (ansible-builder build). • Test idempotency: every task using a module from this collection should be changed=0 on a second run. If not, file an issue or guard with changed_when. • Read the changelog before upgrading — minor and patch releases of community collections occasionally include breaking fixes that the maintainers consider "correctness" rather than SemVer-breaking.

Should You Upgrade?

• If you're on the same MAJOR version, upgrading to 5.1.0 is generally safe and brings bug fixes plus new module parameters. • If 5.1.0 is a new MAJOR (X.0.0), review the changelog for module renames, removed parameters, and deprecation warnings — these accumulate even in actively-maintained collections. • For locked enterprise deployments, stage the upgrade in a non-production Execution Environment first.

Frequently Asked Questions

How do I install community.docker 5.1.0 from Ansible Galaxy?

ansible-galaxy collection install community.docker:5.1.0

To upgrade an existing install in place, append --upgrade (or --force to overwrite without version check).

Where does Ansible install collections by default?

User collections install to ~/.ansible/collections/ansible_collections/community/docker/. System-wide installs go to /usr/share/ansible/collections/. Override with the -p / --collections-path flag or the ANSIBLE_COLLECTIONS_PATH environment variable.

Can I use community.docker 5.1.0 with older ansible-core versions?

Most community collections declare a minimum ansible-core requirement in their runtime.yml. Run ansible-galaxy collection install and watch for warnings; if the collection requires a newer ansible-core than yours, the install will warn and modules may fail at runtime with cryptic errors. Always upgrade ansible-core in lockstep with major collection bumps.

How do I report a bug in community.docker?

Open an issue at https://github.com/ansible-collections/community.docker including the output of ansible --version, ansible-galaxy collection list community.docker, and a minimal playbook reproducer.

Is community.docker certified by Red Hat?

community. collections are community-maintained and not included in Red Hat Ansible Automation Platform's certified content stream. For supported equivalents, look for the matching redhat. or vendor-specific certified collection on https://console.redhat.com/ansible/automation-hub.

Related Articles

• the Ansible Galaxy reference • community.docker collection overview