chore: ansible restart systemd service, use builtin ansible

ansible/plays/service/service-deploy-and-restart.yml

@@ -36,15 +36,24 @@
         regexp: '\{\{\s*agebd_env\s*\}\}'
         replace: "{{ agebd_env }}"
 
-    - name: "[{{ service_name_lower }}] Restart Systemd Service using Relative Paths"
-      ansible.builtin.shell: |
-        export XDG_RUNTIME_DIR=/run/user/$(id -u)
-        
-        # Tell systemd to link the service file into its registry relatively
-        systemctl --user link "./{{ service_unit_name }}"
-        
-        systemctl --user daemon-reload
-        systemctl --user enable "{{ service_unit_name }}"
-        systemctl --user restart "{{ service_unit_name }}"
-      args:
-        chdir: "{{ svc_current_dir }}/systemd"
+      # systemctl --user link --force "./{{ service_unit_name }}"
+    - name: "[{{ service_name_lower }}] Symlink systemd unit file (Absolute Path)"
+      ansible.builtin.file:
+        src: "{{ svc_current_dir }}/systemd/{{ service_unit_name }}"
+        dest: "~/.config/systemd/user/{{ service_unit_name }}"
+        state: link
+        force: yes # This overwrites the broken/existing symlink cleanly without error
+
+      # export XDG_RUNTIME_DIR=/run/user/$(id -u)
+      # systemctl --user daemon-reload
+      # systemctl --user enable "{{ service_unit_name }}"
+      # systemctl --user restart "{{ service_unit_name }}"
+    - name: "[{{ service_name_lower }}] Enable and Restart Systemd Service"
+      ansible.builtin.systemd_service:
+        name: "{{ service_unit_name }}"
+        scope: user
+        daemon_reload: yes
+        enabled: yes
+        state: restarted
+      environment:
+        XDG_RUNTIME_DIR: "/run/user/{{ ansible_user_uid }}"

docs/systemd-service.md

@@ -5,4 +5,6 @@
 ```
 sudo su svcusr-sls2hla
 journalctl --user -u AGEBD-SERVICE-MASTER.service
-```
+```
+
+### TODO: maybe add -DEV to name in cicd when deploying.