Release 3.12.0.

This commit is contained in:
Felix Fontein 2024-08-07 16:15:23 +02:00
parent 3cc27ecd65
commit d797af0d67
13 changed files with 454 additions and 363 deletions

File diff suppressed because it is too large Load Diff

View File

@ -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
=======

View File

@ -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'

View File

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

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."

View File

@ -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)."