[stable-3] docker_image_build: add note on strange behavior (#1007)

* Add note on strange behavior.

* Document strange behavior in changelog.
This commit is contained in:
Felix Fontein 2024-12-14 15:12:54 +01:00 committed by GitHub
parent 4ab7733579
commit edd0186288
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 10 additions and 0 deletions

View File

@ -0,0 +1,6 @@
known_issues:
- "docker_image_build - when ``outputs`` is specified, all entries with ``type=image``, ``type=oci`` and ``type=docker`` have their
name overwritten by the values provided in ``name`` and ``tag``. This happens because the module provides the ``--tag`` option
with the values of the ``name`` and ``tag`` options to Docker the buildx plugin, which for some reason takes that value and
uses it to overwrite the values in ``--output`` parameters
(https://github.com/ansible-collections/community.docker/issues/1001, https://github.com/ansible-collections/community.docker/pull/1007)."

View File

@ -175,6 +175,10 @@ options:
be created, which can cause the basic idempotency this module offers to not work.
- Providing an empty list to this option is equivalent to not specifying it at all.
The default behavior is a single entry with O(outputs[].type=image).
- B(Note) that for some reason Docker the buildx plugin overwrites the image name
of every entry with O(outputs[].type=image), O(outputs[].type=oci), or O(outputs[].type=docker)
with the image name specified in O(name)/O(tag). We will not work around this in community.docker 3.x.y
for backwards compatibility. Please upgrade to community.docker 4.2.0 or newer for a workaround.
type: list
elements: dict
version_added: 3.10.0