Ansible Role Turn

THIS ROLE HAS BEEN ARCHIVED AS OF DEC 2023.

This role helps you install and set up a (co)turn server on your system.

GitHub	GitLab	Downloads	Version

Example Playbook

Here’s a simple example from molecule/default/converge.yml. This is tested every time there's a push, pull request, or release.

---
- name: Converge
  hosts: all
  become: yes
  gather_facts: yes

  roles:
    - role: robertdebock.turn
      turn_listening_ip: "0.0.0.0"
      turn_external_ip: "1.2.3.4"

Before running this, you should prepare your machine. This is done in CI using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.epel

For a complete guide on how to use these roles, check out this page.

Role Variables

Default values for the variables are set in defaults/main.yml:

---
# defaults file for turn

turn_listening_port: 3478
turn_fingerprint: yes
turn_lt_cred_mech: no
turn_use_auth_secret: yes
turn_static_auth_secret: 96ef8dbed1ba36132d9cccfa608d1f90f879d7fb38cb5c18
turn_realm: nextcloud.meinit.nl
turn_total_quota: 100
turn_bps_quota: 0
turn_stale_nonce: 600
turn_no_loopback_peers: yes
turn_no_multicast_peers: yes
turn_simple_log: yes
turn_cli_password: 5S4QtTbkC2tzJj4jRKePZJlmCVU3ljnG
turn_server_name: "{{ ansible_fqdn }}"
turn_listening_ip: "{{ ansible_default_ipv4.address }}"
turn_external_ip: "{{ ansible_default_ipv4.address }}"

Requirements

• Make sure you have the pip packages listed in requirements.txt.

State of Used Roles

The following roles help prepare your system. You can choose another way if you like.

Requirement	GitHub	GitLab
robertdebock.bootstrap
robertdebock.epel

Context

This role is part of a larger set of compatible roles. For more information, check the documentation.

Here’s a look at related roles:

Compatibility

This role has been tested with these container images:

You'll need at least Ansible version 2.12. Tests were performed on:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub.

License

This project is licensed under Apache-2.0.

Author Information

Created by robertdebock.

Feel free to sponsor me if you find this project helpful.