Merge pull request #14 from ganto/role-deps

Remove hard role dependency on debops.ferm

README.md

@@ -35,13 +35,6 @@ into your playbook.
 [Try DebOps now](https://github.com/debops/debops) for a complete solution to run your Debian-based infrastructure.
 
 
-### Role dependencies
-
-- `debops.ferm`
-
-
-
-
 ### Authors and license
 
 `checkmk_server` role was written by:

defaults/main.yml

@@ -35,14 +35,6 @@ checkmk_server__patches:
     file: '/omd/versions/{{ checkmk_server__version_label }}/skel/etc/apache/conf.d/omd.conf'
 
 
-# .. envvar:: checkmk_server__dependencies
-#
-# Enable execution of ``debops.checkmk_server`` role dependencies. This
-# variable can be used in playbooks to disable hardcoded dependencies during
-# transition to playbook-based ones.
-checkmk_server__dependencies: True
-
-
 # .. envvar:: checkmk_server__ferm_dependent_rules
 #
 # Firewall configuration using the ``debops.ferm`` Ansible role.

docs/getting-started.rst

@@ -4,20 +4,15 @@ Getting started
 Example playbook
 ----------------
 
-Here's an example playbook that uses the ``debops.checkmk_server`` role::
+Here's an example playbook that uses the ``debops.checkmk_server`` role:
 
-    ---
-
-    - name: Manage Check_MK server
-      hosts: [ 'debops_service_checkmk_server', 'debops_checkmk_server' ]
-      become: True
-
-      roles:
-        - role: debops.checkmk_server
-          tags: [ 'role::checkmk_server' ]
+.. literalinclude:: playbooks/checkmk_server.yml
+   :language: yaml
 
 This playbook will install the Check_MK server package along with its dependencies,
 and configure a minimal monitoring service with default values generated by Ansible.
+The inclusion of the ``debops.ferm`` is optional.
+
 
 Ansible tags
 ------------

docs/index.rst

@@ -5,7 +5,6 @@ Ansible role: debops.checkmk_server
    :maxdepth: 2
 
    introduction
-   installation
    getting-started
    defaults
    defaults-configuration

docs/introduction.rst

@@ -10,3 +10,11 @@ a powerful configuration language for creating check inventories.
 .. _Check_MK: http://mathias-kettner.com/check_mk.html
 .. _Nagios: https://www.nagios.org/
 .. _Icinga: https://www.icinga.org/
+
+
+Installation
+~~~~~~~~~~~~
+
+This role requires at least Ansible ``v2.0``. To install it, run::
+
+    ansible-galaxy install debops-contrib.checkmk_server

docs/playbooks/checkmk_server.yml

@@ -0,0 +1,16 @@
+---
+
+- name: Manage Check_MK server
+  hosts: [ 'debops_service_checkmk_server', 'debops_checkmk_server' ]
+  become: True
+
+  roles:
+
+    - role: debops.ferm
+      tags: [ 'depend::ferm', 'depend::ferm:checkmk_server', 'depend-of::checkmk_server', 'type::dependency' ]
+      ferm__dependent_rules:
+        - '{{ checkmk_server__ferm_dependent_rules }}'
+
+    - role: debops-contrib.checkmk_server
+      tags: [ 'role::checkmk_server' ]
+

meta/main.yml

@@ -1,12 +1,6 @@
 ---
 
-dependencies:
-
-  - role: debops.ferm
-    tags: [ 'depend::ferm', 'depend::ferm:checkmk_server', 'depend-of::checkmk_server', 'type::dependency' ]
-    ferm__dependent_rules: '{{ checkmk_server__ferm_dependent_rules }}'
-    when: checkmk_server__dependencies | bool
-
+dependencies: []
 
 galaxy_info: