feat: add macos support

Author: MonolithProjects

defaults/main.yml

@@ -1,6 +1,6 @@
 ---
 # Runner user - user under which is the local runner service running
-runner_user: "{{ lookup('env','USER') }}"
+runner_user: "{{ lookup('env', 'USER') }}"
 
 # Directory where the local runner will be installed
 runner_dir: /opt/actions-runner

tasks/collect_info.yml

@@ -1,5 +1,7 @@
 ---
-- block:
+- name: Info collections
+  check_mode: false
+  block:
   - name: Set complete API url for repo runner
     ansible.builtin.set_fact:
       github_full_api_url: "{{ github_api_url }}/repos/{{ github_owner | default(github_account) }}/{{ github_repo }}/actions/runners"
@@ -34,12 +36,37 @@
     register: registered_runners
     run_once: true
 
-  - name: Check service facts
-    ansible.builtin.service_facts:
-
   - name: Get Runner User IDs
-    ansible.builtin.getent:
-      database: passwd
-      key: "{{ runner_user }}"
+    ansible.builtin.command: id -u "{{ runner_user }}"
+    changed_when: false
+    register: runner_user_id
 
-  check_mode: false
+  - name: Get Runner Group IDs
+    ansible.builtin.command: id -g "{{ runner_user }}"
+    changed_when: false
+    register: runner_user_group_id
+
+  - name: Set runner_system variable
+    ansible.builtin.set_fact:
+      runner_system: "{{ 'osx' if ansible_system == 'Darwin' else 'linux' }}"
+
+  - name: Find the latest runner version (RUN ONCE)
+    ansible.builtin.uri:
+      url: "https://api.github.com/repos/{{ runner_download_repository }}/releases/latest"
+      headers:
+        Content-Type: "application/json"
+      method: GET
+      return_content: yes
+      status_code: 200
+      body_format: json
+    check_mode: false
+    register: api_response
+    run_once: true
+    become: false
+    delegate_to: localhost
+    when: runner_version == "latest"
+
+  - name: Get systemd service facts
+    ansible.builtin.service_facts:
+    register: service_facts
+    when: ansible_system == "Linux"

tasks/install_deps.yml

@@ -50,7 +50,7 @@
       - libicu72
     state: present
     update_cache: yes
-  when: (ansible_distribution == "Debian" and ansible_distribution_release == "bookworm")
+  when: (ansible_distribution == "Debian" and ansible_distribution_major_version == "12")
 
 - name: Install dependencies on Ubuntu Xenial systems
   ansible.builtin.package:
@@ -91,10 +91,22 @@
     update_cache: yes
   when: (ansible_distribution == "Ubuntu" and ansible_distribution_major_version == "20")
 
+- name: Install dependencies on Ubuntu Jammy systems
+  ansible.builtin.package:
+    pkg:
+      - acl
+      - liblttng-ust1
+      - libkrb5-3
+      - zlib1g
+      - libssl1.1
+      - libicu66
+    state: present
+    update_cache: yes
+  when: (ansible_distribution == "Ubuntu" and ansible_distribution_major_version == "22")
+
 - name: Install dependencies on RHEL/CentOS/Fedora systems
   ansible.builtin.package:
     name:
-      - acl
       - lttng-ust
       - openssl-libs
       - krb5-libs

tasks/install_runner.yml

@@ -4,24 +4,8 @@
     path: "{{ runner_dir }}"
     state: directory
     mode: 0755
-    owner: "{{ ansible_facts.getent_passwd[runner_user].1 }}"
-    group: "{{ ansible_facts.getent_passwd[runner_user].2 }}"
-
-- name: Find the latest runner version (RUN ONCE)
-  ansible.builtin.uri:
-    url: "https://api.github.com/repos/{{ runner_download_repository }}/releases/latest"
-    headers:
-      Content-Type: "application/json"
-    method: GET
-    return_content: yes
-    status_code: 200
-    body_format: json
-  check_mode: false
-  register: api_response
-  run_once: true
-  become: false
-  delegate_to: localhost
-  when: runner_version == "latest"
+    owner: "{{ runner_user_id.stdout }}"
+    group: "{{ runner_user_group_id.stdout }}"
 
 - name: Set runner_version variable (If latest)
   ansible.builtin.set_fact:
@@ -38,13 +22,14 @@
 - name: Unarchive runner package
   ansible.builtin.unarchive:
     src: "https://github.com/{{ runner_download_repository }}/releases/download/v{{ runner_version }}/\
-          actions-runner-linux-{{ github_actions_architecture }}-{{ runner_version }}.tar.gz"
+          actions-runner-{{ runner_system }}-{{ github_actions_architecture }}-{{ runner_version }}.tar.gz"
     dest: "{{ runner_dir }}/"
-    owner: "{{ ansible_facts.getent_passwd[runner_user].1 }}"
-    group: "{{ ansible_facts.getent_passwd[runner_user].2 }}"
+    owner: "{{ runner_user_id.stdout }}"
+    group: "{{ runner_user_group_id.stdout }}"
     remote_src: yes
     mode: 0755
-  become: true
+  environment:
+    PATH: /usr/local/bin:/opt/homebrew/bin/:{{ ansible_env.HOME }}/bin:{{ ansible_env.PATH }}
   when: runner_version not in runner_installed.stdout or reinstall_runner
 
 - name: Configure custom env file if required
@@ -87,7 +72,6 @@
     {{ runner_extra_config_args }}"
   args:
     chdir: "{{ runner_dir }}"
-  become: true
   become_user: "{{ runner_user }}"
   no_log: "{{ hide_sensitive_logs | bool }}"
   when: runner_name not in registered_runners.json.runners|map(attribute='name')|list
@@ -106,7 +90,6 @@
     --replace"
   args:
     chdir: "{{ runner_dir }}"
-  become: true
   become_user: "{{ runner_user }}"
   no_log: "{{ hide_sensitive_logs | bool }}"
   when: runner_name in registered_runners.json.runners|map(attribute='name')|list and reinstall_runner and not runner_org
@@ -115,32 +98,41 @@
   ansible.builtin.command: "./svc.sh install {{ runner_user }}"
   args:
     chdir: "{{ runner_dir }}"
+  become: "{{ 'false' if ansible_system == 'Darwin' else 'true' }}"
   when: not runner_service_file_path.stat.exists
 
 - name: Read service name from file
   ansible.builtin.slurp:
     src: "{{ runner_dir }}/.service"
   register: runner_service
 
-- name: START and enable Github Actions Runner service
-  ansible.builtin.systemd:
-    name: "{{ runner_service.content | b64decode | replace('\n', '') }}"
-    state: started
-    enabled: yes
+- name: START and enable Github Actions Runner service # DOTO: Idempotence works only for Systemd. Need to fix for launchd.
+  ansible.builtin.command: "./svc.sh start"
+  args:
+    chdir: "{{ runner_dir }}"
+  become: "{{ 'false' if ansible_system == 'Darwin' else 'true' }}"
+  no_log: "{{ hide_sensitive_logs | bool }}"
   ignore_errors: "{{ ansible_check_mode }}"
-  when: runner_state|lower == "started"
+  when: runner_state|lower == "started" and ansible_facts.services[(runner_service.content | b64decode) | trim ]['state'] != 'running'
 
 - name: STOP and disable Github Actions Runner service
-  ansible.builtin.systemd:
-    name: "{{ runner_service.content | b64decode | replace('\n', '') }}"
-    state: stopped
-    enabled: no
+  ansible.builtin.shell: "./svc.sh stop"
+  args:
+    chdir: "{{ runner_dir }}"
+  become: "{{ 'false' if ansible_distribution == 'MacOS' else 'true' }}"
+  no_log: "{{ hide_sensitive_logs | bool }}"
   ignore_errors: "{{ ansible_check_mode }}"
   when: runner_state|lower == "stopped"
 
 - name: Version changed - RESTART Github Actions Runner service
-  ansible.builtin.systemd:
-    name: "{{ runner_service.content | b64decode | replace('\n', '') }}"
-    state: restarted
+  ansible.builtin.shell:
+    cmd: |
+      ./svc.sh stop
+      sleep 5
+      ./svc.sh start
+  args:
+    chdir: "{{ runner_dir }}"
+  become: "{{ 'false' if ansible_system == 'Darwin' else 'true' }}"
+  no_log: "{{ hide_sensitive_logs | bool }}"
   ignore_errors: "{{ ansible_check_mode }}"
   when: runner_version not in runner_installed.stdout and not runner_state|lower == "stopped"

tasks/uninstall_runner.yml

@@ -8,7 +8,7 @@
   ansible.builtin.command: "./svc.sh uninstall"
   args:
     chdir: "{{ runner_dir }}"
-  become: true
+  become: "{{ 'false' if ansible_system == 'Darwin' else 'true' }}"
   when: runner_service_file_path.stat.exists
 
 - name: Check GitHub Actions runner file
@@ -22,7 +22,7 @@
   ansible.builtin.command: "./config.sh remove --token {{ registration.json.token }} --name '{{ runner_name }}' --unattended"
   args:
     chdir: "{{ runner_dir }}"
-  become: true
+  become: false
   become_user: "{{ runner_user }}"
   no_log: "{{ hide_sensitive_logs | bool }}"
   when: runner_name in registered_runners.json.runners|map(attribute='name')|list and runner_file.stat.exists