Release 3.0.0-a2.

2025-12-16 03:52:05 +00:00 · 2022-07-15 19:28:10 +02:00 · 2022-07-15 19:28:10 +02:00 · 0e3d7d4802
commit 0e3d7d4802
parent e26890a909
8 changed files with 98 additions and 29 deletions
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@ -5,6 +5,44 @@ Docker Community Collection Release Notes
 .. contents:: Topics


+v3.0.0-a2
+=========
+
+Release Summary
+---------------
+
+Second alpha prerelease of community.docker 3.0.0. This version again has several breaking changes
+and features rewrites of several modules to directly use the API using ``requests``, instead of using
+the Docker SDK for Python.
+
+The largest change to the previous 3.0.0-a1 prerelease is that ``docker_container`` module has been
+rewritten. It now also no longer needs the Docker SDK for Python, which allowed to implement some new
+features that were not available before (``platform`` and ``cgroupns_mode`` parameters).
+
+
+Major Changes
+-------------
+
+- docker_container - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_container - the module was completely rewritten from scratch (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_plugin - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/429).
+
+Minor Changes
+-------------
+
+- docker_container - add a new parameter ``image_comparison`` to control the behavior for which image will be used for idempotency checks (https://github.com/ansible-collections/community.docker/issues/421, https://github.com/ansible-collections/community.docker/pull/428).
+- docker_container - add support for ``cgroupns_mode`` (https://github.com/ansible-collections/community.docker/issues/338, https://github.com/ansible-collections/community.docker/pull/427).
+- docker_container - allow to specify ``platform`` (https://github.com/ansible-collections/community.docker/issues/123, https://github.com/ansible-collections/community.docker/pull/426).
+
+Breaking Changes / Porting Guide
+--------------------------------
+
+- docker_container - ``exposed_ports`` is no longer ignored in ``comparisons``. Before, its value was assumed to be identical with the value of ``published_ports`` (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_container - ``log_options`` can no longer be specified when ``log_driver`` is not specified (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_container - ``publish_all_ports`` is no longer ignored in ``comparisons`` (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_container - ``restart_retries`` can no longer be specified when ``restart_policy`` is not specified (https://github.com/ansible-collections/community.docker/pull/422).
+- docker_container - ``stop_timeout`` is no longer ignored for idempotency if told to be not ignored in ``comparisons``. So far it defaulted to ``ignore`` there, and setting it to ``strict`` had no effect (https://github.com/ansible-collections/community.docker/pull/422).
+
 v3.0.0-a1
 =========

--- a/changelogs/changelog.yaml
+++ b/changelogs/changelog.yaml
@ -820,3 +820,63 @@ releases:
    - 414-docker-api.yml
    - 415-socket-improvements.yml
    release_date: '2022-07-07'
+  3.0.0-a2:
+    changes:
+      breaking_changes:
+      - docker_container - ``exposed_ports`` is no longer ignored in ``comparisons``.
+        Before, its value was assumed to be identical with the value of ``published_ports``
+        (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_container - ``log_options`` can no longer be specified when ``log_driver``
+        is not specified (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_container - ``publish_all_ports`` is no longer ignored in ``comparisons``
+        (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_container - ``restart_retries`` can no longer be specified when ``restart_policy``
+        is not specified (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_container - ``stop_timeout`` is no longer ignored for idempotency if
+        told to be not ignored in ``comparisons``. So far it defaulted to ``ignore``
+        there, and setting it to ``strict`` had no effect (https://github.com/ansible-collections/community.docker/pull/422).
+      major_changes:
+      - docker_container - no longer uses the Docker SDK for Python. It requires ``requests``
+        to be installed, and depending on the features used has some more requirements.
+        If the Docker SDK for Python is installed, these requirements are likely met
+        (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_container - the module was completely rewritten from scratch (https://github.com/ansible-collections/community.docker/pull/422).
+      - docker_plugin - no longer uses the Docker SDK for Python. It requires ``requests``
+        to be installed, and depending on the features used has some more requirements.
+        If the Docker SDK for Python is installed, these requirements are likely met
+        (https://github.com/ansible-collections/community.docker/pull/429).
+      minor_changes:
+      - docker_container - add a new parameter ``image_comparison`` to control the
+        behavior for which image will be used for idempotency checks (https://github.com/ansible-collections/community.docker/issues/421,
+        https://github.com/ansible-collections/community.docker/pull/428).
+      - docker_container - add support for ``cgroupns_mode`` (https://github.com/ansible-collections/community.docker/issues/338,
+        https://github.com/ansible-collections/community.docker/pull/427).
+      - docker_container - allow to specify ``platform`` (https://github.com/ansible-collections/community.docker/issues/123,
+        https://github.com/ansible-collections/community.docker/pull/426).
+      release_summary: 'Second alpha prerelease of community.docker 3.0.0. This version
+        again has several breaking changes
+
+        and features rewrites of several modules to directly use the API using ``requests``,
+        instead of using
+
+        the Docker SDK for Python.
+
+
+        The largest change to the previous 3.0.0-a1 prerelease is that ``docker_container``
+        module has been
+
+        rewritten. It now also no longer needs the Docker SDK for Python, which allowed
+        to implement some new
+
+        features that were not available before (``platform`` and ``cgroupns_mode``
+        parameters).
+
+        '
+    fragments:
+    - 3.0.0-a2.yml
+    - 426-docker_container-platform.yml
+    - 427-docker_container-cgroupns_mode.yml
+    - 428-docker_container-image-ignore.yml
+    - 429-docker_plugin.yml
+    - docker_container.yml
+    release_date: '2022-07-15'
--- a/changelogs/fragments/3.0.0-a2.yml
+++ b/changelogs/fragments/3.0.0-a2.yml
@ -1,8 +0,0 @@
-release_summary: |
-  Second alpha prerelease of community.docker 3.0.0. This version again has several breaking changes
-  and features rewrites of several modules to directly use the API using ``requests``, instead of using
-  the Docker SDK for Python.
-
-  The largest change to the previous 3.0.0-a1 prerelease is that ``docker_container`` module has been
-  rewritten. It now also no longer needs the Docker SDK for Python, which allowed to implement some new
-  features that were not available before (``platform`` and ``cgroupns_mode`` parameters).
--- a/changelogs/fragments/426-docker_container-platform.yml
+++ b/changelogs/fragments/426-docker_container-platform.yml
@ -1,2 +0,0 @@
-minor_changes:
-  - "docker_container - allow to specify ``platform`` (https://github.com/ansible-collections/community.docker/issues/123, https://github.com/ansible-collections/community.docker/pull/426)."
--- a/changelogs/fragments/427-docker_container-cgroupns_mode.yml
+++ b/changelogs/fragments/427-docker_container-cgroupns_mode.yml
@ -1,2 +0,0 @@
-minor_changes:
-  - "docker_container - add support for ``cgroupns_mode`` (https://github.com/ansible-collections/community.docker/issues/338, https://github.com/ansible-collections/community.docker/pull/427)."
--- a/changelogs/fragments/428-docker_container-image-ignore.yml
+++ b/changelogs/fragments/428-docker_container-image-ignore.yml
@ -1,2 +0,0 @@
-minor_changes:
-  - "docker_container - add a new parameter ``image_comparison`` to control the behavior for which image will be used for idempotency checks (https://github.com/ansible-collections/community.docker/issues/421, https://github.com/ansible-collections/community.docker/pull/428)."
--- a/changelogs/fragments/429-docker_plugin.yml
+++ b/changelogs/fragments/429-docker_plugin.yml
@ -1,4 +0,0 @@
-major_changes:
-  - docker_plugin - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed,
-    and depending on the features used has some more requirements. If the Docker SDK for Python is installed,
-    these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/429).
--- a/changelogs/fragments/docker_container.yml
+++ b/changelogs/fragments/docker_container.yml
@ -1,11 +0,0 @@
-major_changes:
-  - "docker_container - no longer uses the Docker SDK for Python. It requires ``requests`` to be installed,
-     and depending on the features used has some more requirements. If the Docker SDK for Python is installed,
-     these requirements are likely met (https://github.com/ansible-collections/community.docker/pull/422)."
-  - "docker_container - the module was completely rewritten from scratch (https://github.com/ansible-collections/community.docker/pull/422)."
-breaking_changes:
-  - "docker_container - ``publish_all_ports`` is no longer ignored in ``comparisons`` (https://github.com/ansible-collections/community.docker/pull/422)."
-  - "docker_container - ``exposed_ports`` is no longer ignored in ``comparisons``. Before, its value was assumed to be identical with the value of ``published_ports`` (https://github.com/ansible-collections/community.docker/pull/422)."
-  - "docker_container - ``log_options`` can no longer be specified when ``log_driver`` is not specified (https://github.com/ansible-collections/community.docker/pull/422)."
-  - "docker_container - ``restart_retries`` can no longer be specified when ``restart_policy`` is not specified (https://github.com/ansible-collections/community.docker/pull/422)."
-  - "docker_container - ``stop_timeout`` is no longer ignored for idempotency if told to be not ignored in ``comparisons``. So far it defaulted to ``ignore`` there, and setting it to ``strict`` had no effect (https://github.com/ansible-collections/community.docker/pull/422)."