add grafana role

2025-12-12 14:32:28 +03:00
parent 7c6e8fede3
commit b1bfcfb598
30 changed files with 3425 additions and 0 deletions
--- a/roles/grafana/README.md
+++ b/roles/grafana/README.md
@@ -0,0 +1,107 @@
+genlab.grafana
+=========
+
+This ansible role installs [Grafana](https://github.com/grafana/grafana) - the open-source platform for monitoring and observability. It can produce charts, graphs, and alerts for the web when connected to supported data sources.
+
+This role installs and configures Grafana from a binary distribution. It also:
+
+- Uploads custom dashboards
+
+- Installs plugins
+
+- Imports public dashboards and data sources
+
+- Allows admin password changes
+
+Supports user creation
+ Grafana service requires an environment file at startup, where you can set custom paths for logs (`log_dir`), data (`data_dir`), and plugins (`plugins_dir`). This allows flexible control over Grafana's data storage.
+
+ Requirements
+------------
+
+You need `community.grafana` module. 
+
+Role Variables
+--------------
+
+```
+grafana_user: "grafana"    # user name
+grafana_group: "grafana"   # group name
+grafana_version: 11.5.0    # version
+grafana_port: 3000         # port
+
+# Directory paths  
+dashboard_dir: "/tmp/grafana/dashboards"          # where to copy dashboards from source  
+plugins_dir: "/var/lib/grafana/plugins"           # where to store plugins on target  
+datasource_dir: "/etc/grafana/provisioning/datasources"  # where to store data sources on target  
+log_dir: "/var/log/grafana"                       # where to write logs  
+data_dir: "/var/lib/grafana"                      # where to store Grafana DB  
+
+# Optional configurations  
+grafana_users: []                  # array of user names, passwords, and statuses  
+grafana_plugins: []                # array of plugins to install  
+grafana_public_dashboards: []      # array of public dashboards to import  
+
+# Admin credentials  
+admin_api_username: "secret"       # Grafana admin username  
+admin_api_password: "secret"       # Grafana admin password  
+
+# Source paths  
+dashboard_source_path: "mydir/dashboards"         # path to dashboards on source server  
+datasource_source_path: "mydir/datasources"       # path to data sources on source server  
+```
+
+Dependencies
+------------
+
+None
+
+Example Playbook
+----------------
+
+```yaml
+---
+- name: Converge
+  hosts: all
+  vars:
+    grafana_users:
+      - name: "test"
+        user_login: "test"
+        user_password: "test"
+        user_email: "test@mail.ru"
+        is_admin: false
+    grafana_plugins:
+        version: 2.1.8
+      - name: aceiot-svg-panel
+        version: 0.1.5
+    grafana_public_dashboards:
+      - name: Node Full Exporter
+        id: 1860
+        revision: 36
+  vars_files:
+    - secrets/admin_cred.yml
+
+  roles:
+    - role: genlab.grafana
+      grafana_version: 11.5.0
+      admin_api_username: "{{ grafana.admin_api_username }}"
+      admin_api_password: "{{ grafana.admin_api_password }}"
+      users: "{{ grafana_users }}"
+      plugins: "{{ grafana_plugins }}"
+      public_dashboards: "{{ grafana_public_dashboards }}"
+      dashboard_source_path: "molecule/default/dashboards"
+      datasource_source_path: "molecule/default/datasources"
+      log_dir: "/opt/grafana/data"
+      data_dir: "/opt/grafana/lib"
+
+```
+
+License
+-------
+
+BSD
+
+Author Information
+------------------
+
+corvus-migratorius@proton.me