Add warning about missing normalization if ipaddress is not there on Python 2.

This commit is contained in:
Felix Fontein 2025-11-16 10:54:09 +01:00
parent 6f613d5e97
commit 49484b22dc
2 changed files with 10 additions and 0 deletions

View File

@ -1,2 +1,8 @@
bugfixes:
- "docker_network - fix idempotency for IPv6 addresses and networks with Docker 29.0.0 (https://github.com/ansible-collections/community.docker/pull/1201)."
known_issues:
- "docker_network - when specifying IPv6 addresses or networks, Docker since version 29 no longer returns the orignal address/network used
when creating a network, but normalizes them. The module will try to normalize IP addresses for comparison,
but it uses the ``ipaddress`` module from the Python 3 standard library for that. When using the module with Python 2,
please install the `ipaddress backport for Python 2.x <https://pypi.org/project/ipaddress/>`__
(https://github.com/ansible-collections/community.docker/pull/1203)."

View File

@ -193,6 +193,10 @@ notes:
- The module does not support Docker Swarm. This means that it will not try to disconnect or reconnect services. If services
are connected to the network, deleting the network will fail. When network options are changed, the network has to be
deleted and recreated, so this will fail as well.
- When specifying IPv6 addresses for networks, Docker since version 29 no longer returns the orignal address used
when creating a network, but normalizes them. The module will try to normalize IP addresses for comparison,
but it uses the C(ipaddress) module from the Python 3 standard library for that. When using the module with Python 2,
please install the L(ipaddress backport for Python 2.x, https://pypi.org/project/ipaddress/).
author:
- "Ben Keith (@keitwb)"
- "Chris Houseknecht (@chouseknecht)"