GRM-118: fix: improve runner service stability and deregistration

ansible/roles/gitea-runner/tasks/deregister.yml

@@ -18,13 +18,11 @@
       else {} }}
   when: runner_file_stat.stat.exists | default(false) | bool
 
-- name: Deregister runner with Gitea via CLI
+- name: Deregister runner from Gitea via API
   ansible.builtin.command: >
-    {{ gitea_runner_binary_path }} delete
-    --token {{ registration_token }}
-    --name {{ runner_name }}
-    --instance {{ gitea_url }}
-    --no-interactive
+    curl -sf --connect-timeout 5 --max-time 10 -X DELETE
+    -H "Authorization: token {{ gitea_admin_token | default(registration_token) }}"
+    "{{ gitea_url }}/api/v1/admin/actions/runners/{{ runner_reg.id }}"
   args:
     chdir: "{{ gitea_runner_data_dir }}"
   become: true
@@ -35,10 +33,24 @@
   when:
     - runner_file_stat.stat.exists | default(false) | bool
     - not skip_runner_registration
+    - runner_reg.id is defined
   register: deregister_output
   changed_when: deregister_output.rc == 0
   failed_when: false
 
+- name: Warn if deregistration failed
+  ansible.builtin.debug:
+    msg: >-
+      WARNING: Runner deregistration from Gitea failed (rc={{ deregister_output.rc | default('N/A') }}).
+      The runner entry may remain in Gitea's admin UI as offline.
+      Use an admin token (gitea_admin_token var) to enable automatic cleanup,
+      or remove it manually from {{ gitea_url }}/-/admin/actions/runners
+  when:
+    - runner_file_stat.stat.exists | default(false) | bool
+    - not skip_runner_registration
+    - deregister_output is defined
+    - deregister_output.rc | default(1) != 0
+
 - name: Remove runner registration file
   ansible.builtin.file:
     path: "{{ gitea_runner_data_dir }}/.runner"