From 509099e21109cbbc071a4a87db929a9962a4c6b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Laurent=20Inderm=C3=BChle?= <laurent.indermuehle@pm.me>
Date: Thu, 12 Oct 2023 15:15:03 +0200
Subject: [PATCH] document example with tasks grouped in a block

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
---
 plugins/modules/mysql_info.py | 57 ++++++++++++++++++-----------------
 1 file changed, 30 insertions(+), 27 deletions(-)

diff --git a/plugins/modules/mysql_info.py b/plugins/modules/mysql_info.py
index 03e5ea6..a566501 100644
--- a/plugins/modules/mysql_info.py
+++ b/plugins/modules/mysql_info.py
@@ -126,34 +126,37 @@ EXAMPLES = r'''
     exclude_fields: db_size
     return_empty_dbs: true
 
-- name: Clone users on another server - Step 1
-  delegate_to: server_source
-  community.mysql.mysql_info:
-    filter:
-      - users_privs
-  register: result
-
-# Don't work with sha256_password and cache_sha2_password
-- name: Clone users on another server - Step 2
-  community.mysql.mysql_user:
-    name: "{{ item.name }}"
-    host: "{{ item.host }}"
-    plugin: "{{ item.plugin | default(omit) }}"
-    plugin_auth_string: "{{ item.plugin_auth_string | default(omit) }}"
-    plugin_hash_string: "{{ item.plugin_hash_string | default(omit) }}"
-    tls_require: "{{ item.tls_require | default(omit) }}"
-    priv: "{{ item.priv | default(omit) }}"
-    resource_limits: "{{ item.resource_limits | default(omit) }}"
-    column_case_sensitive: true
-    state: present
-  loop: "{{ result.users_privs }}"
-  loop_control:
-    label: "{{ item.name }}@{{ item.host }}"
-  when:
-    - item.name != 'root'  # In case you don't want to import admin accounts
-    - item.name != 'mariadb.sys'
-    - item.name != 'mysql'
+- name: Clone users from one server to another
+  block:
+  # Step 1
+  - name: Fetch information from a source server
+    delegate_to: server_source
+    community.mysql.mysql_info:
+      filter:
+        - users_privs
+    register: result
 
+  # Step 2
+  # Don't work with sha256_password and cache_sha2_password
+  - name: Clone users fetched in a previous task to a target server
+    community.mysql.mysql_user:
+      name: "{{ item.name }}"
+      host: "{{ item.host }}"
+      plugin: "{{ item.plugin | default(omit) }}"
+      plugin_auth_string: "{{ item.plugin_auth_string | default(omit) }}"
+      plugin_hash_string: "{{ item.plugin_hash_string | default(omit) }}"
+      tls_require: "{{ item.tls_require | default(omit) }}"
+      priv: "{{ item.priv | default(omit) }}"
+      resource_limits: "{{ item.resource_limits | default(omit) }}"
+      column_case_sensitive: true
+      state: present
+    loop: "{{ result.users_privs }}"
+    loop_control:
+      label: "{{ item.name }}@{{ item.host }}"
+    when:
+      - item.name != 'root'  # In case you don't want to import admin accounts
+      - item.name != 'mariadb.sys'
+      - item.name != 'mysql'
 '''
 
 RETURN = r'''