From b8097b0bd6f79f9efb66c4df7676129f86e07bd2 Mon Sep 17 00:00:00 2001
From: Slavi Pantaleev <slavi@devture.com>
Date: Thu, 20 Oct 2022 16:05:55 +0300
Subject: [PATCH] Add support for binary content to matrix-aux

---
 roles/matrix-aux/defaults/main.yml | 9 +++++++++
 roles/matrix-aux/tasks/setup.yml   | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/roles/matrix-aux/defaults/main.yml b/roles/matrix-aux/defaults/main.yml
index e4a4e827..4c1f8879 100644
--- a/roles/matrix-aux/defaults/main.yml
+++ b/roles/matrix-aux/defaults/main.yml
@@ -50,6 +50,9 @@ matrix_aux_file_default_mode: '0640'
 # then you likely need to add `/matrix/some/path` to `matrix_aux_directory_definitions` as well.
 # You don't need to do this for directories that the playbook already creates for you.
 #
+# Use a `content` key for text content and `src` with a location to a file for binary content.
+# The `content` key does not support binary content (see https://github.com/ansible/ansible/issues/11594).
+#
 # Example:
 #
 # matrix_aux_file_definitions:
@@ -69,4 +72,10 @@ matrix_aux_file_default_mode: '0640'
 #     mode: '0600'
 #     owner: 'some-user'
 #     group: 'some-group'
+#
+#   - dest: /matrix/aux/binary-file.dat
+#     src: "/path/to/binary.dat"
+#     mode: '0600'
+#     owner: 'some-user'
+#     group: 'some-group'
 matrix_aux_file_definitions: []
diff --git a/roles/matrix-aux/tasks/setup.yml b/roles/matrix-aux/tasks/setup.yml
index ccb0bdcb..eb0adad4 100644
--- a/roles/matrix-aux/tasks/setup.yml
+++ b/roles/matrix-aux/tasks/setup.yml
@@ -11,8 +11,9 @@
 
 - name: Ensure AUX files are created
   ansible.builtin.copy:
+    src: "{{ item.src if 'src' in item else omit }}"
+    content: "{{ item.content if 'content' in item else omit }}"
     dest: "{{ item.dest }}"
-    content: "{{ item.content }}"
     owner: "{{ item.owner | default(matrix_user_username) }}"
     group: "{{ item.group | default(matrix_user_groupname) }}"
     mode: "{{ item.mode | default(matrix_aux_file_default_mode) }}"