mac_address no longer works with Docker API v1.44+. (#764) (#768)

(cherry picked from commit 648e0652d5)

plugins/modules/docker_container.py

@@ -469,6 +469,7 @@ options:
   mac_address:
     description:
       - Container MAC address (for example, C(92:d0:c6:0a:29:33)).
+      - Note that the global container-wide MAC address is deprecated and no longer used since Docker API version 1.44.
     type: str
   memory:
     description:

tests/integration/targets/docker_container/tasks/tests/options.yml

@@ -2744,46 +2744,48 @@ avoid such warnings, please quote the value.' in (log_options_2.warnings | defau
 ## mac_address #####################################################
 ####################################################################
 
-- name: mac_address
+- when: docker_api_version is version('1.44', '<')
-  docker_container:
+  block:
-    image: "{{ docker_test_image_alpine }}"
+    - name: mac_address
-    command: '/bin/sh -c "sleep 10m"'
+      docker_container:
-    name: "{{ cname }}"
+        image: "{{ docker_test_image_alpine }}"
-    mac_address: 92:d0:c6:0a:29:33
+        command: '/bin/sh -c "sleep 10m"'
-    state: started
+        name: "{{ cname }}"
-  register: mac_address_1
+        mac_address: 92:d0:c6:0a:29:33
+        state: started
+      register: mac_address_1
 
-- name: mac_address (idempotency)
+    - name: mac_address (idempotency)
-  docker_container:
+      docker_container:
-    image: "{{ docker_test_image_alpine }}"
+        image: "{{ docker_test_image_alpine }}"
-    command: '/bin/sh -c "sleep 10m"'
+        command: '/bin/sh -c "sleep 10m"'
-    name: "{{ cname }}"
+        name: "{{ cname }}"
-    mac_address: 92:d0:c6:0a:29:33
+        mac_address: 92:d0:c6:0a:29:33
-    state: started
+        state: started
-  register: mac_address_2
+      register: mac_address_2
 
-- name: mac_address (change)
+    - name: mac_address (change)
-  docker_container:
+      docker_container:
-    image: "{{ docker_test_image_alpine }}"
+        image: "{{ docker_test_image_alpine }}"
-    command: '/bin/sh -c "sleep 10m"'
+        command: '/bin/sh -c "sleep 10m"'
-    name: "{{ cname }}"
+        name: "{{ cname }}"
-    mac_address: 92:d0:c6:0a:29:44
+        mac_address: 92:d0:c6:0a:29:44
-    state: started
+        state: started
-    force_kill: yes
+        force_kill: true
-  register: mac_address_3
+      register: mac_address_3
 
-- name: cleanup
+    - name: cleanup
-  docker_container:
+      docker_container:
-    name: "{{ cname }}"
+        name: "{{ cname }}"
-    state: absent
+        state: absent
-    force_kill: yes
+        force_kill: true
-  diff: no
+      diff: false
 
-- assert:
+    - assert:
-    that:
+        that:
-    - mac_address_1 is changed
+        - mac_address_1 is changed
-    - mac_address_2 is not changed
+        - mac_address_2 is not changed
-    - mac_address_3 is changed
+        - mac_address_3 is changed
 
 ####################################################################
 ## memory ##########################################################