Issue #3: Add Starlink monitoring configuration.

Author: geerlingguy

README.md

@@ -13,6 +13,7 @@ So that's what this is.
   - **Internet Monitoring**: Installs an [`internet-monitoring` Docker config](https://github.com/geerlingguy/internet-monitoring), which exposes a Grafana dashboard with historical uptime, ping stats, and speedtest results over time.
   - **Pi-hole**: Installs the Pi-hole Docker configuration so you can use Pi-hole for network-wide ad-blocking and local DNS. Make sure to update your network router config to direct all DNS queries through your Raspberry Pi if you want to use Pi-hole effectively!
   - **Shelly Plug Monitoring**: Installs a [`shelly-plug-prometheus` exporter](https://github.com/geerlingguy/shelly-plug-prometheus) and a Grafana dashboard, which tracks and displays power usage on a Shelly Plug running on the local network. (This is disabled by default. Enable and configure using the `shelly_plug_*` vars in `config.yml`.)
+  - **Starlink Monitoring**: Installs a [`starlink` prometheus exporter](https://github.com/danopstech/starlink_exporter) and a Grafana dashboard, which tracks and displays Starlink statistics. (This is disabled by default. Enable and configure using the `starlink_enable` var in `config.yml`.)
 
 **IMPORTANT NOTE**: If you use this playbook, it will download a decently-large amount of data through your Internet connection on a daily basis. Don't use it, or tune the `internet-monitoring` setup to not run the speedtests as often, if you have a metered connection!
 

example.config.yml

@@ -6,3 +6,5 @@ shelly_plug_enable: false
 shelly_plug_hostname: my-shelly-plug-host-or-ip
 shelly_plug_http_username: username
 shelly_plug_http_password: password
+
+starlink_enable: false

main.yml

@@ -24,3 +24,7 @@
     - name: Set up Shelly Plug Monitoring.
       ansible.builtin.import_tasks: tasks/shelly-plug.yml
       when: shelly_plug_enable
+
+    - name: Set up Starlink Monitoring.
+      ansible.builtin.import_tasks: tasks/starlink.yml
+      when: starlink_enable

tasks/starlink.yml

@@ -0,0 +1,21 @@
+---
+- name: Ensure Starlink directory exists.
+  file:
+    path: ~/starlink-exporter
+    state: directory
+    mode: 0755
+
+- name: Copy Starlink docker-compose template to Pi.
+  ansible.builtin.template:
+    src: templates/starlink-docker-compose.yml.j2
+    dest: ~/starlink-exporter/docker-compose.yml
+    mode: '0640'
+  become: false
+
+# TODO: The first time this playbook is run, the `pi` user may not be added
+# to the `docker` group, so this task may fail.
+- name: Ensure Starlink Prometheus exporter is running.
+  community.docker.docker_compose:
+    project_src: ~/starlink-exporter/
+    build: false
+  become: false

templates/starlink-docker-compose.yml.j2

@@ -0,0 +1,11 @@
+# {{ ansible_managed }}
+---
+version: "3"
+
+services:
+  starlink-exporter:
+    container_name: starlink-exporter
+    image: danopstech/starlink_exporter
+    ports:
+      - "9817:9817"
+    restart: unless-stopped