matrix-docker-ansible-deploy/roles/custom/matrix-media-repo/tasks/setup_install.yml

# SPDX-FileCopyrightText: 2023 - 2024 Michael Hollister
# SPDX-FileCopyrightText: 2024 Daniel A. Maierhofer
# SPDX-FileCopyrightText: 2024 David Mehren
# SPDX-FileCopyrightText: 2024 Slavi Pantaleev
#
# SPDX-License-Identifier: AGPL-3.0-or-later

---

- name: Ensure media-repo paths exist
  ansible.builtin.file:
    path: "{{ item.path }}"
    state: directory
    mode: '0750'
    owner: "{{ matrix_user_name }}"
    group: "{{ matrix_group_name }}"
  with_items:
    - path: "{{ matrix_media_repo_base_path }}"
      when: true
    - path: "{{ matrix_media_repo_config_path }}"
      when: true
    - path: "{{ matrix_media_repo_data_path }}"
      when: true
    - path: "{{ matrix_media_repo_container_src_files_path }}"
      when: "{{ matrix_media_repo_container_image_self_build }}"
  when: "item.when | bool"

- name: Ensure media-repo support files installed
  ansible.builtin.template:
    src: "{{ role_path }}/templates/media-repo/{{ item }}.j2"
    dest: "{{ matrix_media_repo_base_path }}/{{ item }}"
    mode: '0640'
    owner: "{{ matrix_user_name }}"
    group: "{{ matrix_group_name }}"
  with_items:
    - env
    - labels
  register: matrix_media_repo_support_files_result

- name: Ensure media-repo configuration installed
  ansible.builtin.template:
    src: "{{ role_path }}/templates/media-repo/media-repo.yaml.j2"
    dest: "{{ matrix_media_repo_config_path }}/media-repo.yaml"
    mode: '0640'
    owner: "{{ matrix_user_name }}"
    group: "{{ matrix_group_name }}"
  register: matrix_media_repo_config_result

- name: Ensure media-repo Docker image is pulled
  community.docker.docker_image_pull:
    name: "{{ matrix_media_repo_container_image }}"
    pull: always
  when: "not matrix_media_repo_container_image_self_build | bool"
  register: matrix_media_repo_container_image_pull_result
  retries: "{{ devture_playbook_help_container_retries_count }}"
  delay: "{{ devture_playbook_help_container_retries_delay }}"
  until: matrix_media_repo_container_image_pull_result is not failed

- when: "matrix_media_repo_container_image_self_build | bool"
  block:
    # A checkout owned by a different user (a uid change, an earlier clone by another user, etc.) would make the git task below fail on ownership or permissions.
    - name: Ensure media-repo repository ownership is correct on self-build
      ansible.builtin.file:
        path: "{{ matrix_media_repo_container_src_files_path }}"
        state: directory
        owner: "{{ matrix_user_name }}"
        group: "{{ matrix_group_name }}"
        recurse: true

    - name: Ensure media-repo repository is present on self-build
      ansible.builtin.git:
        repo: "{{ matrix_media_repo_container_image_self_build_repo }}"
        dest: "{{ matrix_media_repo_container_src_files_path }}"
        version: "{{ matrix_media_repo_container_image.split(':')[1] }}"
        force: "yes"
      become: true
      become_user: "{{ matrix_user_name }}"
      register: matrix_media_repo_git_pull_results

    - name: Check if media-repo Docker image exists
      ansible.builtin.command: "{{ devture_systemd_docker_base_host_command_docker }} images --quiet --filter 'reference={{ matrix_media_repo_container_image }}'"
      register: matrix_media_repo_container_image_check_result
      changed_when: false

    # Invoking the `docker build` command here, instead of calling the `docker_image` Ansible module,
    # because the latter does not support BuildKit.
    # See: https://github.com/ansible-collections/community.general/issues/514
    - name: Ensure media-repo Docker image is built
      ansible.builtin.command:
        cmd: "{{ devture_systemd_docker_base_host_command_docker }} build -t {{ matrix_media_repo_container_image }} {{ matrix_media_repo_container_src_files_path }}"
      environment:
        DOCKER_BUILDKIT: 1
      changed_when: true
      when: "matrix_media_repo_git_pull_results.changed | bool or matrix_media_repo_container_image_check_result.stdout == ''"

- name: Check existence of media-repo signing key
  ansible.builtin.stat:
    path: "{{ matrix_media_repo_config_path }}/{{ matrix_media_repo_identifier }}.signing.key"
  register: matrix_media_repo_signing_key_stat

- when: "matrix_media_repo_generate_signing_key | bool and not (matrix_media_repo_signing_key_stat.stat.exists | bool)"
  block:
    - name: Generate media-repo signing key
      ansible.builtin.command:
        cmd: |
          {{ devture_systemd_docker_base_host_command_docker }} run
          --rm
          --name={{ matrix_media_repo_identifier }}-temp
          --user={{ matrix_synapse_uid }}:{{ matrix_synapse_gid }}
          --cap-drop=ALL
          --mount type=bind,src={{ matrix_media_repo_config_path }},dst=/config
          --workdir='/config'
          --entrypoint='generate_signing_key'
          {{ matrix_media_repo_container_image }}
          -output {{ matrix_media_repo_identifier }}.signing.key.TEMP
        creates: "{{ matrix_media_repo_config_path }}/{{ matrix_media_repo_identifier }}.signing.key.TEMP"

    - name: Merge media-repo signing key with homeserver signing key
      ansible.builtin.command:
        cmd: |
          {{ devture_systemd_docker_base_host_command_docker }} run
          --rm
          --name={{ matrix_media_repo_identifier }}-temp
          --user={{ matrix_synapse_uid }}:{{ matrix_synapse_gid }}
          --cap-drop=ALL
          --mount type=bind,src={{ matrix_media_repo_config_path }},dst=/config
          --mount type=bind,src={{ matrix_media_repo_homeserver_signing_key | dirname }},dst=/homeserver-signing-key-dir
          --workdir='/config'
          --entrypoint='combine_signing_keys'
          {{ matrix_media_repo_container_image }}
          -format {{ matrix_homeserver_implementation }} -output /homeserver-signing-key-dir/{{ matrix_media_repo_homeserver_signing_key | basename }}.merged /homeserver-signing-key-dir/{{ matrix_media_repo_homeserver_signing_key | basename }} {{ matrix_media_repo_identifier }}.signing.key.TEMP
        creates: "{{ matrix_media_repo_homeserver_signing_key }}.merged"

    - name: Backup existing homeserver signing key before replacing it
      ansible.builtin.copy:
        remote_src: true
        src: "{{ matrix_media_repo_homeserver_signing_key }}"
        dest: "{{ matrix_media_repo_homeserver_signing_key }}.{{ matrix_homeserver_implementation }}.backup"
        mode: '0644'
        owner: "{{ matrix_user_name }}"
        group: "{{ matrix_group_name }}"

    - name: Replace homeserver signing key with merged signing key
      ansible.builtin.command:
        cmd: "mv {{ matrix_media_repo_homeserver_signing_key }}.merged {{ matrix_media_repo_homeserver_signing_key }}"
        removes: "{{ matrix_media_repo_homeserver_signing_key }}.merged"

    - name: Finalize media-repo signing key setup
      ansible.builtin.command:
        cmd: "mv {{ matrix_media_repo_config_path }}/{{ matrix_media_repo_identifier }}.signing.key.TEMP {{ matrix_media_repo_config_path }}/{{ matrix_media_repo_identifier }}.signing.key"
        removes: "{{ matrix_media_repo_config_path }}/{{ matrix_media_repo_identifier }}.signing.key.TEMP"

- name: Ensure media-repo container network is created
  when: matrix_media_repo_container_network != 'host'
  community.general.docker_network:
    enable_ipv6: "{{ devture_systemd_docker_base_ipv6_enabled }}"
    name: "{{ matrix_media_repo_container_network }}"
    driver: bridge
    driver_options: "{{ devture_systemd_docker_base_container_networks_driver_options }}"

- name: Ensure media-repo service installed
  ansible.builtin.template:
    src: "{{ role_path }}/templates/media-repo/systemd/matrix-media-repo.service.j2"
    dest: "{{ devture_systemd_docker_base_systemd_path }}/{{ matrix_media_repo_identifier }}.service"
    mode: '0640'
  register: matrix_media_repo_systemd_service_result

- name: Determine whether media-repo needs a restart
  ansible.builtin.set_fact:
    matrix_media_repo_restart_necessary: >-
      {{
        matrix_media_repo_config_result.changed | default(false)
        or matrix_media_repo_support_files_result.changed | default(false)
        or matrix_media_repo_systemd_service_result.changed | default(false)
        or matrix_media_repo_container_image_pull_result.changed | default(false)
      }}