update distro check to allow bypass

README.md

@@ -23,18 +23,19 @@ Requires a <a href="https://www.netdata.cloud">Netdata</a> account to use the cl
 
 ### Supported Distros
 
-- AlmaLinux >= 8
+- AlmaLinux >= 9
 - AmazonLinux 2023
-- CentOS >= 8
-- Debian >= 10
-- Fedora >= 29
-- openSUSE >= 15.4
+- Debian >= 12
+- Fedora >= 41
+- openSUSE >= 15.6
 - OracleLinux >= 8
 - Pop!\_OS >= 20.04
-- Redhat Enterprise Linux >= 8
-- Rocky Linux >= 8
+- Redhat Enterprise Linux >= 9
+- Rocky Linux >= 9
 - Ubuntu >= 20.04
 
+> Note: This role will check the distro and <a href="https://docs.ansible.com/ansible/latest/collections/ansible/builtin/meta_module.html#parameter-free_form">skip the role</a> if the distro is not supported. This can be bypassed by setting `netdata_distro_check_bypass` to `true`.
+
 ## Role Variables
 
 By default this role will setup netdata agent with the standalone dashboard enabled.

defaults/main.yml

@@ -32,4 +32,8 @@ netdata_agent_web_allow_from:
 netdata_disable_email_notifications: true
 
 # Distro check bypass
-netdata_bypass_distro_check: false
+netdata_distro_check_bypass: false
+
+# Distro check failstate end_role|end_play|end_host
+# https://docs.ansible.com/ansible/latest/collections/ansible/builtin/meta_module.html#parameter-free_form
+netdata_distro_check_fail_state: end_role

tasks/assert.yml

@@ -1,10 +1,4 @@
 ---
-- name: "Test if netdata_bypass_distro_check is set correctly"
-  ansible.builtin.assert:
-    that:
-      - netdata_bypass_distro_check is defined
-      - netdata_bypass_distro_check is boolean
-    quiet: true
 
 - name: "Test if netdata_cloud_enable is set correctly"
   ansible.builtin.assert:
@@ -81,3 +75,18 @@
       - netdata_disable_email_notifications is defined
       - netdata_disable_email_notifications is boolean
     quiet: true
+
+- name: "Test if netdata_distro_check_bypass is set correctly"
+  ansible.builtin.assert:
+    that:
+      - netdata_distro_check_bypass is defined
+      - netdata_distro_check_bypass is boolean
+    quiet: true
+
+- name: "Test if netdata_distro_check_fail_state is set correctly"
+  ansible.builtin.assert:
+    that:
+      - netdata_distro_check_fail_state is defined
+      - netdata_distro_check_fail_state is string
+      - netdata_distro_check_fail_state in ['end_role', 'end_play', 'end_host']
+    quiet: true

tasks/distro-requirements.yml

@@ -22,5 +22,5 @@
   when: distro_supported is false and "molecule-notest" in ansible_skip_tags
 
 - name: "Skip role if distro or architecture is not supported"
-  ansible.builtin.meta: end_role
+  ansible.builtin.meta: "{{ netdata_distro_check_fail_state }}"
   when: distro_supported is false

tasks/main.yml

@@ -17,7 +17,7 @@
 
 - name: "Distro Requirements"
   ansible.builtin.include_tasks: distro-requirements.yml
-  when: netdata_bypass_distro_check is not defined or netdata_bypass_distro_check is false
+  when: netdata_distro_check_bypass is not defined or netdata_distro_check_bypass is false
 
 - name: "Become block"
   become: true