Control grafana service state

Author: sjpb

README.md

@@ -59,7 +59,8 @@ All variables which can be overridden are stored in [defaults/main.yml](defaults
 | `grafana_environment` | {} | Optional Environment param for Grafana installation, useful ie for setting http_proxy |
 | `grafana_plugins` | [] |  List of Grafana plugins which should be installed |
 | `grafana_alert_notifications` | [] | List of alert notification channels to be created, updated, or deleted |
-
+| `grafana_state` | `started` | Grafana service state after this role, either `started` or `stopped` (restarts will happen as required for changed configuration etc. only in `started` mode) |
+| `grafana_enabled` | true | Whether Grafana service is enabled on restart |
 Datasource example:
 
 ```yaml

defaults/main.yml

@@ -251,3 +251,7 @@ grafana_environment: {}
 grafana_panels: {}
 #  disable_sanitize_html: false
 #  enable_alpha: false
+
+# Control service state
+grafana_enabled: true
+grafana_state: started

handlers/main.yml

@@ -4,6 +4,7 @@
   service:
     name: grafana-server
     state: restarted
+  when: "grafana_state != 'stopped'"
   tags:
     - grafana_run
 

tasks/configure.yml

@@ -82,6 +82,6 @@
 - name: Enable and start Grafana systemd unit
   systemd:
     name: grafana-server
-    enabled: true
-    state: started
+    enabled: "{{ grafana_enabled }}"
+    state: "{{ 'stopped' if grafana_state == 'stopped' else 'started' }}"
     daemon_reload: true

tasks/main.yml

@@ -51,7 +51,9 @@
   wait_for:
     host: "{{ grafana_address }}"
     port: "{{ grafana_port }}"
-  when: grafana_server.protocol is undefined or grafana_server.protocol in ['http', 'https']
+  when:
+    - grafana_state != 'stopped'
+    - grafana_server.protocol is undefined or grafana_server.protocol in ['http', 'https']
   tags:
     - grafana_install
     - grafana_configure
@@ -63,7 +65,9 @@
 - name: Wait for grafana to start (socket)
   wait_for:
     path: "{{ grafana_server.socket }}"
-  when: grafana_server.protocol is defined and grafana_server.protocol == 'socket'
+  when:
+    - grafana_state != 'stopped'
+    - grafana_server.protocol is defined and grafana_server.protocol == 'socket'
   tags:
     - grafana_install
     - grafana_configure