ansible_fencl/update_uptime_kuma.yml

# nextcloud/update_uptime_kuma.yml

- name: Update Uptime Kuma on VM via Proxmox
  hosts: proxmox
  gather_facts: false
  become: true
  become_user: root
  become_method: sudo

  vars:
    # VM connection (provided by Semaphore env vars)
    vm_ip:   "{{ lookup('env', 'VM_IP') }}"
    vm_user: "{{ lookup('env', 'VM_USER') }}"
    vm_pass: "{{ lookup('env', 'VM_PASS') }}"
    use_sudo: false

    # --- Debug mode (controlled via Semaphore variable) ---
    DEBUG: "{{ lookup('env', 'DEBUG') | default(0) | int }}"
    RETRIES: "{{ lookup('env', 'RETRIES') | default(25) | int }}"

    # Uptime Kuma specifics
    kuma_project: "uptime-kuma"
    kuma_compose_file: "/data/compose/uptime-kuma/docker-compose-uptime-kuma.yml"
    kuma_service: "uptime-kuma"
    kuma_image: "louislam/uptime-kuma:latest"
    kuma_port: 3001

    # Optional external URL for controller-side readiness check (e.g., https://kuma.example.com)
    # If empty/undefined, controller check is skipped and we only probe from the VM.
    kuma_url: "{{ lookup('env', 'KUMA_URL') | default('', true) }}"

    # Fixed container name used in your compose (conflicts with previous/Portainer-run container)
    kuma_container_name: "uptime-kuma-dev"

    # Retry policy
    kuma_retries: "{{ RETRIES }}"
    kuma_delay: 2

    # Docker command prefix (consistent behavior)
    docker_prefix: "unalias docker 2>/dev/null || true; DOCKER_CLI_HINTS=0; command docker"

    # Commands to run on the target VM (quiet outputs like in Collabora play)
    kuma_commands:
      - "{{ docker_prefix }} pull -q {{ kuma_image }} >/dev/null"
      - "{{ docker_prefix }} compose -p {{ kuma_project }} -f {{ kuma_compose_file }} pull {{ kuma_service }} >/dev/null"
      # remove conflicting container name before compose up (silently)
      - "{{ docker_prefix }} rm -f {{ kuma_container_name }} >/dev/null 2>&1 || true"
      - "{{ docker_prefix }} compose -p {{ kuma_project }} -f {{ kuma_compose_file }} up -d --no-deps --force-recreate {{ kuma_service }} >/dev/null"

  tasks:
    - name: Ensure sshpass is installed (for password-based SSH)  # English comments
      ansible.builtin.apt:
        name: sshpass
        state: present
        update_cache: yes

    - name: Run Uptime Kuma update commands on VM (via SSH)  # use SSHPASS env, hide item label
      ansible.builtin.command:
        argv:
          - sshpass
          - -e                     # read password from SSHPASS environment
          - ssh
          - -o
          - StrictHostKeyChecking=no
          - -o
          - ConnectTimeout=15
          - "{{ vm_user }}@{{ vm_ip }}"
          - bash
          - -lc
          - "{{ ('sudo ' if use_sudo else '') + item }}"
      environment:
        SSHPASS: "{{ vm_pass }}"    # supply password via environment
      loop: "{{ kuma_commands }}"
      loop_control:
        index_var: idx              # capture loop index
        label: "cmd-{{ idx }}"      # avoid printing full command in (item=...) line
      register: kuma_cmds
      changed_when: false
      no_log: "{{ DEBUG == 0 }}"    # hide outputs and env when not debugging

    - name: Show outputs for each Uptime Kuma command
      ansible.builtin.debug:
        msg: |
          CMD: {{ item.item }}
          RC:  {{ item.rc }}
          STDOUT:
          {{ (item.stdout | default('')).strip() }}
          STDERR:
          {{ (item.stderr | default('')).strip() }}
      loop: "{{ kuma_cmds.results }}"
      when: DEBUG == 1

    - name: Fail play if any Uptime Kuma command failed  # also hide item label
      ansible.builtin.assert:
        that: "item.rc == 0"
        fail_msg: "Uptime Kuma update failed on VM: {{ item.item }} (rc={{ item.rc }})"
        success_msg: "All Uptime Kuma update commands succeeded."
      loop: "{{ kuma_cmds.results }}"
      loop_control:
        index_var: idx
        label: "cmd-{{ idx }}"

    # -------------------------
    # Readiness checks (controller first, then VM fallback)
    # -------------------------

    - name: Kuma | Wait for homepage (controller first, with retries)
      ansible.builtin.uri:
        url: "{{ (kuma_url | regex_replace('/$','')) + '/' }}"
        method: GET
        return_content: true
        # Validate TLS only when using https://
        validate_certs: "{{ (kuma_url | default('')) is match('^https://') }}"
        status_code: 200
      register: kuma_controller
      delegate_to: localhost
      run_once: true
      when: kuma_url is defined and (kuma_url | length) > 0
      retries: "{{ kuma_retries }}"
      delay: "{{ kuma_delay }}"
      until: kuma_controller.status == 200
      failed_when: false
      changed_when: false

    - name: Kuma | VM-side fetch (HTML via Python, with retries)  # use SSHPASS env here too
      ansible.builtin.command:
        argv:
          - sshpass
          - -e
          - ssh
          - -o
          - StrictHostKeyChecking=no
          - -o
          - ConnectTimeout=15
          - "{{ vm_user }}@{{ vm_ip }}"
          - bash
          - -lc
          - |
            python3 - <<'PY'
            # Fetch Kuma homepage from localhost and print HTML to stdout
            import urllib.request, sys
            try:
                with urllib.request.urlopen("http://127.0.0.1:{{ kuma_port }}/", timeout=15) as r:
                    sys.stdout.write(r.read().decode(errors='ignore'))
            except Exception:
                pass
            PY
      environment:
        SSHPASS: "{{ vm_pass }}"
      register: kuma_vm
      changed_when: false
      failed_when: false
      when: kuma_controller.status | default(0) != 200 or kuma_controller.content is not defined
      retries: "{{ kuma_retries }}"
      delay: "{{ kuma_delay }}"
      until: (kuma_vm.stdout | default('') | trim | length) > 0 and ('Uptime Kuma' in (kuma_vm.stdout | default('')))
      no_log: "{{ DEBUG == 0 }}"   # hide command and output when not debugging

    - name: Kuma | Choose homepage HTML (controller wins, else VM)  # safe guard against empty result
      ansible.builtin.set_fact:
        kuma_home_html: >-
          {{
            (
              kuma_controller.content
              if (kuma_controller is defined)
                 and ((kuma_controller.status|default(0))==200)
                 and (kuma_controller.content is defined)
              else
                 (kuma_vm.stdout | default('') | trim)
            )
          }}
      when:
        - (kuma_controller is defined and (kuma_controller.status|default(0))==200 and (kuma_controller.content is defined))
          or ((kuma_vm.stdout | default('') | trim | length) > 0)

    - name: Kuma | Print concise summary
      ansible.builtin.debug:
        msg: >-
          Uptime Kuma homepage {{ 'reachable' if (kuma_home_html is defined) else 'NOT reachable' }}.
          Source={{ 'controller' if ((kuma_controller is defined) and (kuma_controller.status|default(0))==200 and (kuma_controller.content is defined)) else 'vm' if (kuma_vm.stdout|default('')|trim|length>0) else 'n/a' }};
          length={{ (kuma_home_html | default('')) | length }};
          contains('Uptime Kuma')={{ (kuma_home_html is defined) and ('Uptime Kuma' in kuma_home_html) }}
      when: DEBUG == 1

    - name: Kuma | Homepage unavailable (after retries)
      ansible.builtin.debug:
        msg: "Kuma web není dostupná ani po pokusech."
      when: kuma_home_html is not defined and DEBUG == 1

    # Optional detailed dump (short excerpt only)
    - name: Kuma | HTML excerpt (debug)
      ansible.builtin.debug:
        msg: "{{ (kuma_home_html | default(''))[:500] }}"
      when: kuma_home_html is defined and DEBUG == 1