Vendor Galaxy Roles and Collections

ansible_collections/community/docker/tests/integration/targets/docker_volume/aliases

@@ -0,0 +1,6 @@
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+azp/4
+destructive

ansible_collections/community/docker/tests/integration/targets/docker_volume/meta/main.yml

@@ -0,0 +1,8 @@
+---
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+dependencies:
+  - setup_docker
+  - setup_docker_python_deps

ansible_collections/community/docker/tests/integration/targets/docker_volume/tasks/main.yml

@@ -0,0 +1,36 @@
+---
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+####################################################################
+# WARNING: These are designed specifically for Ansible tests       #
+# and should not be used as examples of how to write Ansible roles #
+####################################################################
+
+- name: Create random name prefix
+  ansible.builtin.set_fact:
+    name_prefix: "{{ 'ansible-docker-test-%0x' % ((2**32) | random) }}"
+    vnames: []
+
+- ansible.builtin.debug:
+    msg: "Using name prefix {{ name_prefix }}"
+
+- block:
+    - ansible.builtin.include_tasks: run-test.yml
+      with_fileglob:
+        - "tests/*.yml"
+      loop_control:
+        loop_var: test_name
+
+  always:
+    - name: "Make sure all volumes are removed"
+      community.docker.docker_volume:
+        name: "{{ item }}"
+        state: absent
+      with_items: "{{ vnames }}"
+
+  when: docker_api_version is version('1.25', '>=')
+
+- ansible.builtin.fail: msg="Too old docker / docker-py version to run docker_volume tests!"
+  when: not(docker_api_version is version('1.25', '>=')) and (ansible_distribution != 'CentOS' or ansible_distribution_major_version|int > 6)

ansible_collections/community/docker/tests/integration/targets/docker_volume/tasks/run-test.yml

@@ -0,0 +1,7 @@
+---
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+- name: "Loading tasks from {{ test_name }}"
+  ansible.builtin.include_tasks: "{{ test_name }}"

ansible_collections/community/docker/tests/integration/targets/docker_volume/tasks/tests/basic.yml

@@ -0,0 +1,191 @@
+---
+# Copyright (c) Ansible Project
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+- name: Registering volume name
+  ansible.builtin.set_fact:
+    vname: "{{ name_prefix ~ '-basic' }}"
+- name: Registering container name
+  ansible.builtin.set_fact:
+    vnames: "{{ vnames + [vname] }}"
+
+####################################################################
+## basic ###########################################################
+####################################################################
+
+- name: Create a volume
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+  register: create_1
+
+- name: Create a volume (idempotency)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+  register: create_2
+
+- name: "Create a volume (recreate: options-changed)"
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    recreate: options-changed
+  register: create_3
+
+- name: "Create a volume (recreate: always)"
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    recreate: always
+  register: create_4
+
+- name: Remove a volume
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    state: absent
+  register: absent_1
+
+- name: Remove a volume (idempotency)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    state: absent
+  register: absent_2
+
+- ansible.builtin.assert:
+    that:
+      - create_1 is changed
+      - create_2 is not changed
+      - create_3 is not changed
+      - create_4 is changed
+      - absent_1 is changed
+      - absent_2 is not changed
+
+####################################################################
+## driver_options ##################################################
+####################################################################
+
+- name: Create a volume with options
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    driver: local
+    driver_options:
+      type: tempfs
+      device: tmpfs
+      o: size=100m,uid=1000
+  register: driver_options_1
+
+- name: Create a volume with options (idempotency)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    driver: local
+    driver_options:
+      type: tempfs
+      device: tmpfs
+      o: size=100m,uid=1000
+  register: driver_options_2
+
+- name: Create a volume with options (changed)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    driver: local
+    driver_options:
+      type: tempfs
+      device: tmpfs
+      o: size=200m,uid=1000
+  register: driver_options_3
+
+- name: "Create a volume with options (changed, recreate: options-changed)"
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    driver: local
+    driver_options:
+      type: tempfs
+      device: tmpfs
+      o: size=200m,uid=1000
+    recreate: options-changed
+  register: driver_options_4
+
+- name: Cleanup
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    state: absent
+
+- ansible.builtin.assert:
+    that:
+      - driver_options_1 is changed
+      - driver_options_2 is not changed
+      - driver_options_3 is not changed
+      - driver_options_4 is changed
+
+####################################################################
+## labels ##########################################################
+####################################################################
+
+- name: Create a volume with an invalid label
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      foo: 1.0
+  register: driver_labels_invalid
+  ignore_errors: true
+
+- name: Create a volume with labels
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.1: hello
+      ansible.test.2: world
+  register: driver_labels_1
+
+- name: Create a volume with labels (idempotency)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.2: world
+      ansible.test.1: hello
+  register: driver_labels_2
+
+- name: Create a volume with labels (less)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.1: hello
+  register: driver_labels_3
+
+- name: "Create a volume with labels (less, recreate: options-changed)"
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.1: hello
+    recreate: options-changed
+  register: driver_labels_4
+
+- name: Create a volume with labels (more)
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.1: hello
+      ansible.test.3: ansible
+  register: driver_labels_5
+
+- name: "Create a volume with labels (more, recreate: options-changed)"
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    labels:
+      ansible.test.1: hello
+      ansible.test.3: ansible
+    recreate: options-changed
+  register: driver_labels_6
+
+- name: Cleanup
+  community.docker.docker_volume:
+    name: "{{ vname }}"
+    state: absent
+
+- ansible.builtin.assert:
+    that:
+      - driver_labels_invalid is failed
+      - driver_labels_invalid.msg == "The value 1.0 for 'foo' of labels is not a string or something than can be safely converted to a string!"
+      - driver_labels_1 is changed
+      - driver_labels_2 is not changed
+      - driver_labels_3 is not changed
+      - driver_labels_4 is not changed
+      - driver_labels_5 is not changed
+      - driver_labels_6 is changed