Release 3.12.0.

changelogs/changelog.yaml

@@ -1821,3 +1821,61 @@ releases:
       - 921-docker_container-healthy.yml
       - 922-docker_container-wait-fix.yml
     release_date: '2024-07-09'
+  3.12.0:
+    changes:
+      bugfixes:
+        - docker_compose_v2 - handle yet another random unstructured error output
+          from pre-2.29.0 Compose versions (https://github.com/ansible-collections/community.docker/issues/948,
+          https://github.com/ansible-collections/community.docker/pull/949).
+        - docker_compose_v2 - make sure that services provided in ``services`` are
+          appended to the command line after ``--`` and not before it (https://github.com/ansible-collections/community.docker/pull/942).
+        - docker_compose_v2* modules, docker_image_build - provide better error message
+          when required fields are not present in ``docker version`` or ``docker info``
+          output. This can happen if Podman is used instead of Docker (https://github.com/ansible-collections/community.docker/issues/891,
+          https://github.com/ansible-collections/community.docker/pull/935).
+        - docker_container - fix idempotency if ``network_mode=default`` and Docker
+          26.1.0 or later is used. There was a breaking change in Docker 26.1.0 regarding
+          normalization of ``NetworkMode`` (https://github.com/ansible-collections/community.docker/issues/934,
+          https://github.com/ansible-collections/community.docker/pull/936).
+        - docker_container - restore behavior of the module from community.docker
+          2.x.y that passes the first network to the Docker Deamon while creating
+          the container (https://github.com/ansible-collections/community.docker/pull/933).
+        - docker_image_build - fix ``--output`` parameter composition for ``type=docker``
+          and ``type=image`` (https://github.com/ansible-collections/community.docker/issues/946,
+          https://github.com/ansible-collections/community.docker/pull/947).
+      known_issues:
+        - docker_container - when specifying a MAC address for a container's network,
+          and the network is attached after container creation (for example, due to
+          idempotency checks), the MAC address is at least in some cases ignored by
+          the Docker Daemon (https://github.com/ansible-collections/community.docker/pull/933).
+      minor_changes:
+        - docker, docker_api connection plugins - allow to determine the working directory
+          when executing commands with the new ``working_dir`` option (https://github.com/ansible-collections/community.docker/pull/943).
+        - docker, docker_api connection plugins - allow to execute commands with extended
+          privileges with the new ``privileges`` option (https://github.com/ansible-collections/community.docker/pull/943).
+        - docker, docker_api connection plugins - allow to pass extra environment
+          variables when executing commands with the new ``extra_env`` option (https://github.com/ansible-collections/community.docker/issues/937,
+          https://github.com/ansible-collections/community.docker/pull/940).
+        - docker_compose_v2* modules - support Docker Compose 2.29.0's ``json`` progress
+          writer to avoid having to parse text output (https://github.com/ansible-collections/community.docker/pull/931).
+        - docker_compose_v2_pull - add new options ``ignore_buildable``, ``include_deps``,
+          and ``services`` (https://github.com/ansible-collections/community.docker/issues/941,
+          https://github.com/ansible-collections/community.docker/pull/942).
+        - docker_container - when creating a container, directly pass all networks
+          to connect to to the Docker Daemon for API version 1.44 and newer. This
+          makes creation more efficient and works around a bug in Docker Daemon that
+          does not use the specified MAC address in at least some cases, though only
+          for creation (https://github.com/ansible-collections/community.docker/pull/933).
+      release_summary: Bugfix and feature release.
+    fragments:
+      - 3.12.0.yml
+      - 931-compose-2.29.0-json.yml
+      - 933-docker_container-networks.yml
+      - 935-cli-errors.yml
+      - 936-network_mode-default.yml
+      - 940-connection-env.yml
+      - 942-compose-v2-pull.yml
+      - 943-connection.yml
+      - 947-docker_image_build.yml
+      - 949-compose-error.yml
+    release_date: '2024-08-07'