From ae6c2d881314054d2d49c3de9f2a55f9271b1133 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Sun, 24 Nov 2024 00:31:51 +0100
Subject: [PATCH] fix(ansible/snippets): strategy and throttle

---
 snippets/ansible/commands.sh |  4 +++-
 snippets/ansible/tasks.yml   | 29 ++++++++++++++++++++++++-----
 2 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/snippets/ansible/commands.sh b/snippets/ansible/commands.sh
index dbf6c75..158efff 100644
--- a/snippets/ansible/commands.sh
+++ b/snippets/ansible/commands.sh
@@ -64,8 +64,10 @@ ansible-vault edit 'ssh.key.pub'
 ANSIBLE_VAULT_PASSWORD_FILE='password_file.txt' ansible-vault decrypt --output '.ssh/id_rsa' 'ssh.key'
 diff 'some_role/files/ssh.key.plain' <(ansible-vault view --vault-password-file 'password_file.txt' 'some_role/files/ssh.key.enc')
 
-# List available 'lookup' plugins.
+# List available plugins.
 ansible-doc -t 'lookup' -l
+ansible-doc -t 'strategy' -l
 
 # Show plugin-specific docs and examples.
 ansible-doc -t 'lookup' 'fileglob'
+ansible-doc -t 'strategy' 'linear'
diff --git a/snippets/ansible/tasks.yml b/snippets/ansible/tasks.yml
index a0bbb66..9f410c3 100644
--- a/snippets/ansible/tasks.yml
+++ b/snippets/ansible/tasks.yml
@@ -367,6 +367,26 @@
               until: job_result.finished
               retries: 9
               delay: 5
+- name: Run this play on up to 3 hosts at a time
+  hosts: large_group_of_hosts
+  serial: 3
+  tasks: []
+- name: Run this play on a batch of 4 hosts, then a batch of 8, then the rest
+  hosts: large_group_of_hosts
+  serial:
+    - 4
+    - 8
+    - 100%
+  strategy: linear
+  tasks:
+    - name: Limit this task to 3 workers (or up to the current batch if lower)
+      throttle: 3
+      ansible.builtin.set_fact:
+        greetings: hi from {{ ansible_hostname }}
+    # - name: Run this task only on one single host
+    #   run_once: true
+    #   ansible.builtin.set_fact:
+    #     confirm: only run on {{ ansible_hostname }}
 
 - name: Debugging
   tags:
@@ -383,7 +403,7 @@
     - name: Pretty print messages
       vars:
         install_method: package
-        supported_install_methods: [ 'package' ]
+        supported_install_methods: ['package']
       ansible.builtin.debug:
         msg: >-
           {{
@@ -589,7 +609,7 @@
     - name: Add repositories
       block:
         - name: To DNF/YUM
-          when: ansible_pkg_mgr | lower in [ 'dnf', 'yum' ]
+          when: ansible_pkg_mgr | lower in ['dnf', 'yum']
           ansible.builtin.yum_repository:
             name: epel
             description: EPEL YUM repo
@@ -880,8 +900,7 @@
           tags: gather_facts
           delegate_to: "{{ new_instance.instance_id }}"
           delegate_facts: true
-          ansible.builtin.gather_facts:
-            # alternatively, use 'ansible.builtin.setup' to allow for subsets gathering
+          ansible.builtin.gather_facts:  # alternatively, use 'ansible.builtin.setup' to allow for subsets gathering
         - name: DEBUG  Print the new instance's host variables
           delegate_to: "{{ new_instance.instance_id }}"
           ansible.builtin.debug:
@@ -1141,7 +1160,7 @@
   check_mode: true
   tasks:
     - name: Install configured fleeting plugins
-      when: runner_executor in [ "docker-autoscaler", "instance" ]
+      when: runner_executor in ["docker-autoscaler", "instance"]
       become: true
       ansible.builtin.command:
         chdir: /root