---
- when : matrix_coturn_turn_external_ip_address_auto_detection_enabled | bool
block :
- when : matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url == ''
name : Fail if enabled, but EchoIP service URL unset
ansible.builtin.fail :
msg : "To use the external IP address auto-detection feature, you need to set matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url"
# NOTE:
# `ansible.builtin.uri` does not provide a way to configure whether IPv4 or IPv6 is used.
# Luckily, the default instance we use does not define AAAA records for now, so it's always IPv4.
- name : Fetch IP address information from EchoIP service
ansible.builtin.uri :
url : "{{ matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url }}"
headers :
Content-Type : application/json
follow_redirects : none
validate_certs : "{{ matrix_coturn_turn_external_ip_address_auto_detection_echoip_validate_certs }}"
register : result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response
ignore_errors : true
check_mode : false
retries : "{{ matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_retries_count }}"
delay : "{{ matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_retries_delay }}"
until : not result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response.failed
- when : "(result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response.failed or 'json' not in result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response)"
name : Fail if EchoIP service failed
ansible.builtin.fail :
msg : "Failed contacting EchoIP service API at `{{ matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url }}` (controlled by `matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url`). Full error: {{ result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response }}"
- ansible.builtin.set_fact :
matrix_coturn_turn_external_ip_address : "{{ result_matrix_coturn_turn_external_ip_address_auto_detection_echoip_response.json.ip }}"
- name : Ensure Matrix Coturn path exists
ansible.builtin.file :
path : "{{ item.path }}"
state : directory
mode : 0750
owner : "{{ matrix_user_username }}"
group : "{{ matrix_user_groupname }}"
with_items :
- {path : "{{ matrix_coturn_docker_src_files_path }}" , when : "{{ matrix_coturn_container_image_self_build }}" }
when : "item.when | bool"
- name : Ensure Coturn image is pulled
community.docker.docker_image :
name : "{{ matrix_coturn_docker_image }}"
source : "{{ 'pull' if ansible_version.major > 2 or ansible_version.minor > 7 else omit }}"
force_source : "{{ matrix_coturn_docker_image_force_pull if ansible_version.major > 2 or ansible_version.minor >= 8 else omit }}"
force : "{{ omit if ansible_version.major > 2 or ansible_version.minor >= 8 else matrix_coturn_docker_image_force_pull }}"
when : "not matrix_coturn_container_image_self_build | bool"
register : result
retries : "{{ devture_playbook_help_container_retries_count }}"
delay : "{{ devture_playbook_help_container_retries_delay }}"
until : result is not failed
- when : "matrix_coturn_container_image_self_build | bool"
block :
- name : Ensure Coturn repository is present on self-build
ansible.builtin.git :
repo : "{{ matrix_coturn_container_image_self_build_repo }}"
dest : "{{ matrix_coturn_docker_src_files_path }}"
version : "{{ matrix_coturn_container_image_self_build_repo_version }}"
force : "yes"
become : true
become_user : "{{ matrix_user_username }}"
register : matrix_coturn_git_pull_results
- name : Ensure Coturn Docker image is built
community.docker.docker_image :
name : "{{ matrix_coturn_docker_image }}"
source : build
force_source : "{{ matrix_coturn_git_pull_results.changed if ansible_version.major > 2 or ansible_version.minor >= 8 else omit }}"
force : "{{ omit if ansible_version.major > 2 or ansible_version.minor >= 8 else matrix_coturn_git_pull_results.changed }}"
build :
dockerfile : "{{ matrix_coturn_container_image_self_build_repo_dockerfile_path }}"
path : "{{ matrix_coturn_docker_src_files_path }}"
pull : true
- name : Ensure Coturn configuration path exists
ansible.builtin.file :
path : "{{ matrix_coturn_base_path }}"
state : directory
mode : 0750
owner : "{{ matrix_user_username }}"
group : "{{ matrix_user_groupname }}"
- name : Ensure turnserver.conf installed
ansible.builtin.template :
src : "{{ role_path }}/templates/turnserver.conf.j2"
dest : "{{ matrix_coturn_config_path }}"
mode : 0644
owner : "{{ matrix_user_username }}"
group : "{{ matrix_user_groupname }}"
- name : Ensure Coturn network is created in Docker
when : matrix_coturn_docker_network not in ['', 'host']
community.docker.docker_network :
name : "{{ matrix_coturn_docker_network }}"
driver : bridge
- name : Ensure matrix-coturn.service installed
ansible.builtin.template :
src : "{{ role_path }}/templates/systemd/matrix-coturn.service.j2"
dest : "{{ devture_systemd_docker_base_systemd_path }}/matrix-coturn.service"
mode : 0644
# This may be unnecessary when more long-lived certificates are used.
# We optimize for the common use-case though (short-lived Let's Encrypt certificates).
# Reloading doesn't hurt anyway, so there's no need to make this more flexible.
- name : Ensure reloading systemd units installed, if necessary
ansible.builtin.template :
src : "{{ role_path }}/templates/systemd/{{ item }}.j2"
dest : "{{ devture_systemd_docker_base_systemd_path }}/{{ item }}"
mode : 0644
when : "matrix_coturn_tls_enabled | bool"
with_items :
- matrix-coturn-reload.service
- matrix-coturn-reload.timer
# A similar task exists in `setup_uninstall.yml`
- name : Ensure reloading systemd units uninstalled, if unnecessary
ansible.builtin.file :
path : "{{ item }}"
state : absent
when : "not matrix_coturn_tls_enabled | bool"
with_items :
- matrix-coturn-reload.service
- matrix-coturn-reload.timer