Release 3.12.0.

CHANGELOG.rst

@@ -4,6 +4,39 @@ Docker Community Collection Release Notes
 
 .. contents:: Topics
 
+v3.12.0
+=======
+
+Release Summary
+---------------
+
+Bugfix and feature release.
+
+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).
+
+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).
+
 v3.11.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'

changelogs/fragments/3.12.0.yml

@@ -1 +0,0 @@
-release_summary: Bugfix and feature release.

changelogs/fragments/931-compose-2.29.0-json.yml

@@ -1,2 +0,0 @@
-minor_changes:
-  - "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)."

changelogs/fragments/933-docker_container-networks.yml

@@ -1,12 +0,0 @@
-minor_changes:
-  - "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)."
-bugfixes:
-  - "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)."
-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)."

changelogs/fragments/935-cli-errors.yml

@@ -1,4 +0,0 @@
-bugfixes:
-  - "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)."

changelogs/fragments/936-network_mode-default.yml

@@ -1,4 +0,0 @@
-bugfixes:
-  - "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)."

changelogs/fragments/940-connection-env.yml

@@ -1,2 +0,0 @@
-minor_changes:
-  - "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)."

changelogs/fragments/942-compose-v2-pull.yml

@@ -1,6 +0,0 @@
-minor_changes:
-  - "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)."
-bugfixes:
-  - "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)."

changelogs/fragments/943-connection.yml

@@ -1,3 +0,0 @@
-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)."

changelogs/fragments/947-docker_image_build.yml

@@ -1,2 +0,0 @@
-bugfixes:
-  - "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)."

changelogs/fragments/949-compose-error.yml

@@ -1,2 +0,0 @@
-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)."