Sanitized mirror from private repository - 2026-03-12 10:40:05 UTC

docs/advanced/ansible/playbooks/common/backup_configs.yml

@@ -0,0 +1,48 @@
+---
+# Backup all docker-compose configs and data
+- name: Backup Docker configurations
+  hosts: "{{ target_host | default('all') }}"
+  gather_facts: true
+
+  vars:
+    backup_dest: "{{ backup_path | default('/backup') }}"
+    backup_timestamp: "{{ ansible_date_time.date }}_{{ ansible_date_time.hour }}{{ ansible_date_time.minute }}"
+
+  tasks:
+    - name: Create backup directory
+      ansible.builtin.file:
+        path: "{{ backup_dest }}/{{ inventory_hostname }}"
+        state: directory
+        mode: '0755'
+      become: "{{ ansible_become | default(false) }}"
+      delegate_to: localhost
+
+    - name: Find all docker-compose files
+      ansible.builtin.find:
+        paths: "{{ docker_data_path }}"
+        patterns: "docker-compose.yml,docker-compose.yaml,.env"
+        recurse: true
+      register: compose_files
+
+    - name: Archive docker configs
+      ansible.builtin.archive:
+        path: "{{ docker_data_path }}"
+        dest: "/tmp/{{ inventory_hostname }}_configs_{{ backup_timestamp }}.tar.gz"
+        format: gz
+        exclude_path:
+          - "*/data/*"
+          - "*/logs/*"
+          - "*/cache/*"
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Fetch backup to control node
+      ansible.builtin.fetch:
+        src: "/tmp/{{ inventory_hostname }}_configs_{{ backup_timestamp }}.tar.gz"
+        dest: "{{ backup_dest }}/{{ inventory_hostname }}/"
+        flat: true
+
+    - name: Clean up remote archive
+      ansible.builtin.file:
+        path: "/tmp/{{ inventory_hostname }}_configs_{{ backup_timestamp }}.tar.gz"
+        state: absent
+      become: "{{ ansible_become | default(false) }}"

docs/advanced/ansible/playbooks/common/install_docker.yml

@@ -0,0 +1,55 @@
+---
+# Install Docker on a host (for non-Synology systems)
+- name: Install Docker
+  hosts: "{{ target_host | default('all:!synology') }}"
+  become: true
+  gather_facts: true
+
+  tasks:
+    - name: Install prerequisites
+      ansible.builtin.apt:
+        name:
+          - apt-transport-https
+          - ca-certificates
+          - curl
+          - gnupg
+          - lsb-release
+          - python3-pip
+        state: present
+        update_cache: true
+      when: ansible_os_family == "Debian"
+
+    - name: Add Docker GPG key
+      ansible.builtin.apt_key:
+        url: https://download.docker.com/linux/{{ ansible_distribution | lower }}/gpg
+        state: present
+      when: ansible_os_family == "Debian"
+
+    - name: Add Docker repository
+      ansible.builtin.apt_repository:
+        repo: "deb https://download.docker.com/linux/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} stable"
+        state: present
+      when: ansible_os_family == "Debian"
+
+    - name: Install Docker
+      ansible.builtin.apt:
+        name:
+          - docker-ce
+          - docker-ce-cli
+          - containerd.io
+          - docker-compose-plugin
+        state: present
+        update_cache: true
+      when: ansible_os_family == "Debian"
+
+    - name: Ensure Docker service is running
+      ansible.builtin.service:
+        name: docker
+        state: started
+        enabled: true
+
+    - name: Add user to docker group
+      ansible.builtin.user:
+        name: "{{ ansible_user }}"
+        groups: docker
+        append: true

docs/advanced/ansible/playbooks/common/logs.yml

@@ -0,0 +1,27 @@
+---
+# View logs for a specific service
+# Usage: ansible-playbook playbooks/common/logs.yml -e "service_name=plex" -e "target_host=atlantis"
+- name: View service logs
+  hosts: "{{ target_host }}"
+  gather_facts: false
+
+  vars:
+    log_lines: 100
+    follow_logs: false
+
+  tasks:
+    - name: Validate service_name is provided
+      ansible.builtin.fail:
+        msg: "service_name variable is required. Use -e 'service_name=<name>'"
+      when: service_name is not defined
+
+    - name: Get service logs
+      ansible.builtin.command:
+        cmd: "docker compose logs --tail={{ log_lines }} {{ '--follow' if follow_logs else '' }}"
+        chdir: "{{ docker_data_path }}/{{ service_name }}"
+      register: logs_result
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Display logs
+      ansible.builtin.debug:
+        msg: "{{ logs_result.stdout }}"

docs/advanced/ansible/playbooks/common/restart_service.yml

@@ -0,0 +1,23 @@
+---
+# Restart a specific service
+# Usage: ansible-playbook playbooks/common/restart_service.yml -e "service_name=plex" -e "target_host=atlantis"
+- name: Restart Docker service
+  hosts: "{{ target_host }}"
+  gather_facts: false
+
+  tasks:
+    - name: Validate service_name is provided
+      ansible.builtin.fail:
+        msg: "service_name variable is required. Use -e 'service_name=<name>'"
+      when: service_name is not defined
+
+    - name: Restart service
+      ansible.builtin.command:
+        cmd: docker compose restart
+        chdir: "{{ docker_data_path }}/{{ service_name }}"
+      register: restart_result
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Display result
+      ansible.builtin.debug:
+        msg: "Service {{ service_name }} restarted on {{ inventory_hostname }}"

docs/advanced/ansible/playbooks/common/setup_directories.yml

@@ -0,0 +1,34 @@
+---
+# Setup base directories for Docker services
+- name: Setup Docker directories
+  hosts: "{{ target_host | default('all') }}"
+  gather_facts: true
+
+  tasks:
+    - name: Create base docker directory
+      ansible.builtin.file:
+        path: "{{ docker_data_path }}"
+        state: directory
+        mode: '0755'
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Create common directories
+      ansible.builtin.file:
+        path: "{{ docker_data_path }}/{{ item }}"
+        state: directory
+        mode: '0755'
+      loop:
+        - configs
+        - data
+        - logs
+        - backups
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Create service directories from host_services
+      ansible.builtin.file:
+        path: "{{ docker_data_path }}/{{ item.stack_dir }}"
+        state: directory
+        mode: '0755'
+      loop: "{{ host_services | default([]) }}"
+      when: host_services is defined
+      become: "{{ ansible_become | default(false) }}"

docs/advanced/ansible/playbooks/common/status.yml

@@ -0,0 +1,49 @@
+---
+# Check status of all Docker containers
+- name: Check container status
+  hosts: "{{ target_host | default('all') }}"
+  gather_facts: true
+
+  tasks:
+    - name: Get list of running containers
+      ansible.builtin.command:
+        cmd: docker ps --format "table {{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Status{{ '}}' }}\t{{ '{{' }}.Image{{ '}}' }}"
+      register: docker_ps
+      changed_when: false
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Display running containers
+      ansible.builtin.debug:
+        msg: |
+
+          === {{ inventory_hostname }} ===
+          {{ docker_ps.stdout }}
+
+    - name: Get stopped/exited containers
+      ansible.builtin.command:
+        cmd: docker ps -a --filter "status=exited" --format "table {{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Status{{ '}}' }}"
+      register: docker_exited
+      changed_when: false
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Display stopped containers
+      ansible.builtin.debug:
+        msg: |
+
+          === Stopped containers on {{ inventory_hostname }} ===
+          {{ docker_exited.stdout }}
+      when: docker_exited.stdout_lines | length > 1
+
+    - name: Get disk usage
+      ansible.builtin.command:
+        cmd: docker system df
+      register: docker_df
+      changed_when: false
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Display disk usage
+      ansible.builtin.debug:
+        msg: |
+
+          === Docker disk usage on {{ inventory_hostname }} ===
+          {{ docker_df.stdout }}

docs/advanced/ansible/playbooks/common/update_containers.yml

@@ -0,0 +1,46 @@
+---
+# Update all Docker containers (pull new images and recreate)
+- name: Update Docker containers
+  hosts: "{{ target_host | default('all') }}"
+  gather_facts: true
+
+  vars:
+    services: "{{ host_services | default([]) }}"
+
+  tasks:
+    - name: Display update info
+      ansible.builtin.debug:
+        msg: "Updating {{ services | length }} services on {{ inventory_hostname }}"
+
+    - name: Pull latest images for each service
+      ansible.builtin.command:
+        cmd: docker compose pull
+        chdir: "{{ docker_data_path }}/{{ item.stack_dir }}"
+      loop: "{{ services }}"
+      loop_control:
+        label: "{{ item.name }}"
+      when: item.enabled | default(true)
+      register: pull_result
+      changed_when: "'Downloaded' in pull_result.stdout"
+      failed_when: false
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Recreate containers with new images
+      ansible.builtin.command:
+        cmd: docker compose up -d --remove-orphans
+        chdir: "{{ docker_data_path }}/{{ item.stack_dir }}"
+      loop: "{{ services }}"
+      loop_control:
+        label: "{{ item.name }}"
+      when: item.enabled | default(true)
+      register: up_result
+      changed_when: "'Started' in up_result.stdout or 'Recreated' in up_result.stdout"
+      failed_when: false
+      become: "{{ ansible_become | default(false) }}"
+
+    - name: Clean up unused images
+      ansible.builtin.command:
+        cmd: docker image prune -af
+      when: prune_images | default(true)
+      changed_when: false
+      become: "{{ ansible_become | default(false) }}"