feat: Add parameter to skip config check when installing NGINX from a OS repository

Resolves #888

Author: alessfg

CHANGELOG.md

@@ -10,6 +10,7 @@ FEATURES:
 
 - Add support for installing NGINX Open Source and NGINX Plus on Alpine Linux 3.21.
 - Add a parameter, `nginx_distribution_package`, to override the default NGINX package name when installing NGINX from your distribution/OS repository.
+- Add a parameter, `nginx_skip_os_install_config_check`, to turn off the NGINX config check handler when installing NGINX from the respective distribution package manager. This should help avoid potential issues where the default NGINX config that ships with a distribution is broken for some reason.
 
 BUG FIXES:
 

defaults/main/main.yml

@@ -71,6 +71,9 @@ nginx_static_modules: [http_ssl_module]
 
 # (Optional) Specify NGINX package name when installing nginx from an 'os_repository'.
 # nginx_distribution_package: @nginx:1.24/common
+# (Optional) Skip checking the NGINX configuration file after installation when installing NGINX from your OS repository.
+# Not recommended unless you know what you're doing.
+# nginx_skip_os_install_config_check: false
 
 # (Optional) Choose where to fetch the NGINX signing key from.
 # Default is the official NGINX signing key host.

handlers/main.yml

@@ -23,7 +23,7 @@
   ignore_errors: true
   check_mode: false
   changed_when: false
-  when: nginx_state != 'absent'
+  when: nginx_state != 'absent' or (nginx_install_from == 'os_repository' and nginx_skip_os_install_config_check | bool)
   listen: (Handler) Run NGINX
 
 - name: (Handler) Print NGINX error if syntax check fails