v0.5.19

galaxy.yml

@@ -2,7 +2,7 @@
 namespace: uumas
 name: general
 description: General roles
-version: 0.5.17
+version: 0.5.19
 readme: README.md
 authors:
   - uumas

roles/systemd/README.md

@@ -5,5 +5,5 @@ Adds systemd-related notifiable handlers
 - Apply systemd unit restarts
   - Restarts multiple systemd units in a single transaction
   - Units to be restarted are defined in the `systemd_restart_units` variable of type list
-  - The variable should be set using `ansible.builtin.set_fact`
+  - The variable should be set using `ansible.builtin.set_fact`, with `# noqa: var-naming[no-role-prefix]`
   - The list must not be overridden, but appended (`systemd_restart_units: "{{ systemd_restart_units + ['restartme.service'] }}"`

roles/systemd_socket/README.md

@@ -0,0 +1 @@
+Adds a systemd socket for a service

roles/systemd_socket/defaults/main.yaml

@@ -0,0 +1,2 @@
+---
+systemd_socket_requires: []

roles/systemd_socket/handlers/main.yaml

@@ -0,0 +1,6 @@
+---
+- name: Restart socket {{ systemd_socket_name }}
+  ansible.builtin.set_fact:
+    systemd_restart_units: "{{ systemd_restart_units + [systemd_socket_name ~ '.socket'] }}" # noqa: var-naming[no-role-prefix]
+  changed_when: true
+  notify: Apply systemd unit restarts

roles/systemd_socket/meta/argument_specs.yaml

@@ -0,0 +1,16 @@
+---
+argument_specs:
+  main:
+    description:
+      - Adds a systemd socket for a service
+    options:
+      systemd_socket_name:
+        description: Name of the socket. The socket will be created at /run/<systemd_socket_name>.sock
+        type: str
+        required: true
+      systemd_socket_requires:
+        description: List of units this socket depends on.
+        type: list
+        required: false
+        default: []
+        elements: str

roles/systemd_socket/meta/main.yaml

@@ -0,0 +1,3 @@
+---
+dependencies:
+  - role: systemd

roles/systemd_socket/tasks/main.yaml

@@ -0,0 +1,9 @@
+---
+- name: Socket {{ systemd_socket_name }}
+  ansible.builtin.template:
+    src: socket.j2
+    dest: /etc/systemd/system/{{ systemd_socket_name }}.socket
+    mode: "0644"
+  notify:
+    - Reload systemd daemon
+    - Restart socket {{ systemd_socket_name }}

roles/systemd_socket/templates/socket.j2

@@ -0,0 +1,9 @@
+# {{ ansible_managed }}
+[Unit]
+Description={{ systemd_socket_name }} socket
+{% for item in systemd_socket_requires %}
+Requires={{ item }}
+{% endfor %}
+
+[Socket]
+ListenStream=/run/{{ systemd_socket_name }}.sock