feat(playbooks): add example and setup_example playbooks as development references

Author: markuslf

CHANGELOG.md

@@ -19,6 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 * **CONTRIBUTING**: Document semantic parameter ordering for Ansible modules
+* **playbooks**: Add `example.yml` and `setup_example.yml` playbooks as development references
 * **role:example**: Add complete example role with defaults, handlers, tasks, templates, and vars as a reference for consistent role development
 * **role:icingaweb2_module_grafana**: Add JWT support
 * **role:grafana**: Add JWT support

playbooks/example.yml

@@ -0,0 +1,27 @@
+- name: 'Playbook linuxfabrik.lfops.example'
+  hosts:
+    - 'lfops_example'
+
+  pre_tasks:
+    - ansible.builtin.import_role:
+        name: 'shared'
+        tasks_from: 'log-start.yml'
+      tags:
+        - 'always'
+
+
+  roles:
+
+    - role: 'linuxfabrik.lfops.repo_example'
+      when:
+        - 'not example__skip_repo_example | d(false)'
+
+    - role: 'linuxfabrik.lfops.example'
+
+
+  post_tasks:
+    - ansible.builtin.import_role:
+        name: 'shared'
+        tasks_from: 'log-end.yml'
+      tags:
+        - 'always'

playbooks/setup_example.yml

@@ -0,0 +1,83 @@
+# Setup playbook for an application with complex dependencies (webserver, database, etc.).
+# Playbooks with such dependencies are prefixed by "setup_".
+#
+# skip_role and skip_injections variables:
+# - setup_example__<role>__skip_role: skips the role entirely
+# - setup_example__<role>__skip_injections: skips only the dependent_var injections
+#   (defaults to the value of skip_role if not set)
+
+- name: 'Playbook linuxfabrik.lfops.setup_example'
+  hosts:
+    - 'lfops_setup_example'
+
+  vars:
+
+    setup_example__mariadb_server__skip_injections__internal_var: '{{ setup_example__mariadb_server__skip_injections | d(setup_example__mariadb_server__skip_role__internal_var) }}'
+    setup_example__mariadb_server__skip_role__internal_var: '{{ setup_example__mariadb_server__skip_role | d(false) }}'
+
+  pre_tasks:
+    - ansible.builtin.import_role:
+        name: 'shared'
+        tasks_from: 'log-start.yml'
+      tags:
+        - 'always'
+
+
+  roles:
+
+    # === Repositories ===
+    - role: 'linuxfabrik.lfops.repo_baseos'
+      repo_baseos__crb_repo_enabled__dependent_var: '{{
+          repo_epel__repo_baseos__crb_repo_enabled__dependent_var
+        }}'
+      when:
+        - 'ansible_facts["os_family"] == "RedHat"'
+        - 'not setup_example__skip_repo_baseos | d(false)'
+
+    - role: 'linuxfabrik.lfops.repo_epel'
+      when:
+        - 'ansible_facts["os_family"] == "RedHat"'
+        - 'not setup_example__skip_repo_epel | d(false)'
+
+    # === SELinux ===
+    - role: 'linuxfabrik.lfops.policycoreutils'
+      when:
+        - 'ansible_facts["os_family"] == "RedHat"'
+        - 'not setup_example__skip_policycoreutils | d(false)'
+
+    - role: 'linuxfabrik.lfops.selinux'
+      selinux__booleans__dependent_var: '{{
+          example__selinux__booleans__dependent_var
+        }}'
+      when:
+        - 'ansible_facts["os_family"] == "RedHat"'
+        - 'not setup_example__skip_selinux | d(false)'
+
+    # === Web server ===
+    - role: 'linuxfabrik.lfops.apache_httpd'
+      apache_httpd__mods__dependent_var: '{{ example__apache_httpd__mods__dependent_var | d([]) }}'
+      apache_httpd__vhosts__dependent_var: '{{ example__apache_httpd__vhosts__dependent_var | d([]) }}'
+      when:
+        - 'not setup_example__skip_apache_httpd | d(false)'
+
+    # === Database ===
+    - role: 'linuxfabrik.lfops.mariadb_server'
+      mariadb_server__databases__dependent_var: '{{
+          (not setup_example__mariadb_server__skip_injections__internal_var) | ternary(example__mariadb_server__databases__dependent_var, [])
+        }}'
+      mariadb_server__users__dependent_var: '{{
+          (not setup_example__mariadb_server__skip_injections__internal_var) | ternary(example__mariadb_server__users__dependent_var, [])
+        }}'
+      when:
+        - 'not setup_example__mariadb_server__skip_role__internal_var'
+
+    # === Application ===
+    - role: 'linuxfabrik.lfops.example'
+
+
+  post_tasks:
+    - ansible.builtin.import_role:
+        name: 'shared'
+        tasks_from: 'log-end.yml'
+      tags:
+        - 'always'