From 6292c5b552c5c9a469fa0e9fb4507b7643fefe24 Mon Sep 17 00:00:00 2001
From: cloudneutral <haitaopanhq@gmail.com>
Date: Mon, 15 Dec 2025 22:50:20 +0800
Subject: [PATCH] Add Docker Grafana role and deployment playbook

---
 playbooks/deploy_grafana_docker.yaml          | 11 ++++++
 playbooks/roles/docker/grafana/README.md      | 21 +++++++++--
 .../roles/docker/grafana/defaults/main.yml    |  9 +++++
 playbooks/roles/docker/grafana/tasks/main.yml | 36 ++++++++++++++++---
 .../grafana/templates/docker-compose.yaml.j2  | 17 +++++++++
 5 files changed, 88 insertions(+), 6 deletions(-)
 create mode 100644 playbooks/deploy_grafana_docker.yaml
 create mode 100644 playbooks/roles/docker/grafana/defaults/main.yml
 create mode 100644 playbooks/roles/docker/grafana/templates/docker-compose.yaml.j2

diff --git a/playbooks/deploy_grafana_docker.yaml b/playbooks/deploy_grafana_docker.yaml
new file mode 100644
index 0000000..b838032
--- /dev/null
+++ b/playbooks/deploy_grafana_docker.yaml
@@ -0,0 +1,11 @@
+- name: setup grafana (docker)
+  hosts: all
+  become: true
+  vars:
+    grafana_domain: "{{ domain }}"
+    grafana_workspace: /opt/grafana
+    grafana_admin_user: admin
+    grafana_admin_password: admin
+  roles:
+    - vhosts/docker/
+    - docker/grafana/
diff --git a/playbooks/roles/docker/grafana/README.md b/playbooks/roles/docker/grafana/README.md
index 7bf1346..3ddf520 100644
--- a/playbooks/roles/docker/grafana/README.md
+++ b/playbooks/roles/docker/grafana/README.md
@@ -1,3 +1,20 @@
-# grafana (docker)
+# Grafana (Docker)
 
-Placeholder role for docker-compose style deployment of grafana.
+This role deploys Grafana with Docker Compose, creating a persistent data directory and templating a simple `docker-compose.yaml` into `{{ grafana_workspace }}`.
+
+## Defaults
+- `grafana_workspace`: `/opt/grafana`
+- `grafana_image`: `grafana/grafana:10.4.6`
+- `grafana_domain`: `grafana.svc.plus`
+- `grafana_protocol`: `http`
+- `grafana_host_port`: `3000`
+- `grafana_admin_user`: `admin`
+- `grafana_admin_password`: `admin`
+
+## Run
+
+Example playbook execution:
+
+```bash
+ansible-playbook -i inventory.ini playbooks/deploy_grafana_docker.yaml -e "domain=grafana.example.com" -l grafana.example.com
+```
diff --git a/playbooks/roles/docker/grafana/defaults/main.yml b/playbooks/roles/docker/grafana/defaults/main.yml
new file mode 100644
index 0000000..f0e08c5
--- /dev/null
+++ b/playbooks/roles/docker/grafana/defaults/main.yml
@@ -0,0 +1,9 @@
+---
+# Default settings for Grafana Docker deployment
+grafana_workspace: /opt/grafana
+grafana_image: grafana/grafana:10.4.6
+grafana_domain: grafana.svc.plus
+grafana_protocol: http
+grafana_host_port: 3000
+grafana_admin_user: admin
+grafana_admin_password: admin
diff --git a/playbooks/roles/docker/grafana/tasks/main.yml b/playbooks/roles/docker/grafana/tasks/main.yml
index c4f5488..0f76297 100644
--- a/playbooks/roles/docker/grafana/tasks/main.yml
+++ b/playbooks/roles/docker/grafana/tasks/main.yml
@@ -1,5 +1,33 @@
 ---
-# TODO: implement docker deployment tasks
-- name: Placeholder task
-  debug:
-    msg: "Role placeholder. Implement docker deployment tasks."
+- name: Ensure Grafana directories exist
+  become: true
+  ansible.builtin.file:
+    path: "{{ item }}"
+    state: directory
+    mode: "0755"
+  loop:
+    - "{{ grafana_workspace }}"
+    - "{{ grafana_workspace }}/data"
+    - "{{ grafana_workspace }}/provisioning"
+
+- name: Ensure Grafana data directory ownership
+  become: true
+  ansible.builtin.file:
+    path: "{{ grafana_workspace }}/data"
+    state: directory
+    owner: "472"
+    group: "472"
+    recurse: true
+
+- name: Template Grafana Docker Compose file
+  become: true
+  ansible.builtin.template:
+    src: docker-compose.yaml.j2
+    dest: "{{ grafana_workspace }}/docker-compose.yaml"
+    mode: "0644"
+
+- name: Launch Grafana with Docker Compose
+  become: true
+  ansible.builtin.command: docker compose -f {{ grafana_workspace }}/docker-compose.yaml up -d
+  args:
+    chdir: "{{ grafana_workspace }}"
diff --git a/playbooks/roles/docker/grafana/templates/docker-compose.yaml.j2 b/playbooks/roles/docker/grafana/templates/docker-compose.yaml.j2
new file mode 100644
index 0000000..8856844
--- /dev/null
+++ b/playbooks/roles/docker/grafana/templates/docker-compose.yaml.j2
@@ -0,0 +1,17 @@
+version: '3.9'
+services:
+  grafana:
+    image: "{{ grafana_image }}"
+    container_name: grafana
+    restart: unless-stopped
+    environment:
+      GF_SECURITY_ADMIN_USER: "{{ grafana_admin_user }}"
+      GF_SECURITY_ADMIN_PASSWORD: "{{ grafana_admin_password }}"
+      GF_SERVER_DOMAIN: "{{ grafana_domain }}"
+      GF_SERVER_ROOT_URL: "{{ grafana_protocol }}://{{ grafana_domain }}/"
+    ports:
+      - "{{ grafana_host_port }}:3000"
+    volumes:
+      - "{{ grafana_workspace }}/data:/var/lib/grafana"
+      - "{{ grafana_workspace }}/provisioning:/etc/grafana/provisioning"
+    user: "472:472"