From e33ae979ab81d8d278b676e26ef7c22315692039 Mon Sep 17 00:00:00 2001 From: Mathieu Gauthier-Pilote Date: Wed, 17 May 2023 16:04:19 -0400 Subject: [PATCH 01/28] WIP --- webapps/jitsimeet/LISEZMOI.md | 47 ++++++++++++++++++++++++++ webapps/jitsimeet/README.md | 47 ++++++++++++++++++++++++++ webapps/jitsimeet/defaults/main.yml | 10 ++++++ webapps/jitsimeet/handlers/main.yml | 2 ++ webapps/jitsimeet/meta/main.yml | 52 +++++++++++++++++++++++++++++ webapps/jitsimeet/tasks/main.yml | 47 ++++++++++++++++++++++++++ webapps/jitsimeet/tasks/upgrade.yml | 4 +++ webapps/jitsimeet/tests/inventory | 2 ++ webapps/jitsimeet/tests/test.yml | 5 +++ webapps/jitsimeet/vars/main.yml | 2 ++ 10 files changed, 218 insertions(+) create mode 100644 webapps/jitsimeet/LISEZMOI.md create mode 100644 webapps/jitsimeet/README.md create mode 100644 webapps/jitsimeet/defaults/main.yml create mode 100644 webapps/jitsimeet/handlers/main.yml create mode 100644 webapps/jitsimeet/meta/main.yml create mode 100644 webapps/jitsimeet/tasks/main.yml create mode 100644 webapps/jitsimeet/tasks/upgrade.yml create mode 100644 webapps/jitsimeet/tests/inventory create mode 100644 webapps/jitsimeet/tests/test.yml create mode 100644 webapps/jitsimeet/vars/main.yml diff --git a/webapps/jitsimeet/LISEZMOI.md b/webapps/jitsimeet/LISEZMOI.md new file mode 100644 index 00000000..29594f79 --- /dev/null +++ b/webapps/jitsimeet/LISEZMOI.md @@ -0,0 +1,47 @@ +jitsimeet +===== + +Ce rôle installe un serveur jitsimeet. + +Notez qu'hormis le présent fichier LISEZMOI.md, tous les fichiers du rôle jitsimeet sont rédigés en anglais afin de suivre les conventions de la communauté Ansible, favoriser sa réutilisation et son amélioration, etc. Libre à vous cependant de faire appel à ce role dans un playbook rédigé principalement en français ou toute autre langue. + +Requis +------ + +... + +Variables du rôle +----------------- + +Plusieurs des valeurs par défaut dans defaults/main.yml doivent être changées soit directement dans defaults/main.yml ou mieux encore en les supplantant ailleurs, par exemple dans votre playbook (voir l'exemple ci-bas). + +Dépendances +------------ + +... + +Exemple de playbook +------------------- + +``` +- name: "Déployer un serveur jitsimeet" + hosts: + - all + vars: + # Supplanter ici les variables du rôle + domains: ['votre-vrai-domaine.org'] + service: 'mon-jitsimeet' + + roles: + - { role: webapps/jitsimeet , tags: "jitsimeet" } +``` + +Licence +------- + +GPLv3 + +Infos sur l'auteur +------------------ + +Mathieu Gauthier-Pilote, administrateur de systèmes chez Evolix. diff --git a/webapps/jitsimeet/README.md b/webapps/jitsimeet/README.md new file mode 100644 index 00000000..a1f1463a --- /dev/null +++ b/webapps/jitsimeet/README.md @@ -0,0 +1,47 @@ +jitsimeet +===== + +This role installs or upgrades the server for jitsimeet. + +FRENCH: Voir le fichier LISEZMOI.md pour le français. + +Requirements +------------ + +... + +Role Variables +-------------- + +Several of the default values in defaults/main.yml must be changed either directly in defaults/main.yml or better even by overwriting them somewhere else, for example in your playbook (see the example below). + +Dependencies +------------ + +... + +Example Playbook +---------------- + +``` +- name: "Deploy a jitsimeet server" + hosts: + - all + vars: + # Overwrite the role variables here + domains: ['your-real-domain.org'] + service: 'my-jitsimeet' + + roles: + - { role: webapps/jitsimeet , tags: "jitsimeet" } +``` + +License +------- + +GPLv3 + +Author Information +------------------ + +Mathieu Gauthier-Pilote, sys. admin. at Evolix. diff --git a/webapps/jitsimeet/defaults/main.yml b/webapps/jitsimeet/defaults/main.yml new file mode 100644 index 00000000..d6813d04 --- /dev/null +++ b/webapps/jitsimeet/defaults/main.yml @@ -0,0 +1,10 @@ +--- +# defaults file for main vars + +system_dep: "['gnupg2', 'curl', 'apt-transport-https', 'default-jdk', 'nginx-full', 'lua5.2']" + +domains: ['bullseye.domaine-fictif.org'] + +version: "stable-8319" # 7 March 2023 +version_old: "stable-8252" # used by jitsimeet/tasks/upgrade.yml + diff --git a/webapps/jitsimeet/handlers/main.yml b/webapps/jitsimeet/handlers/main.yml new file mode 100644 index 00000000..214734cf --- /dev/null +++ b/webapps/jitsimeet/handlers/main.yml @@ -0,0 +1,2 @@ +--- +# handlers file diff --git a/webapps/jitsimeet/meta/main.yml b/webapps/jitsimeet/meta/main.yml new file mode 100644 index 00000000..b065fb2a --- /dev/null +++ b/webapps/jitsimeet/meta/main.yml @@ -0,0 +1,52 @@ +galaxy_info: + author: Mathieu Gauthier-Pilote + description: sys. admin. + company: Evolix + + # If the issue tracker for your role is not on github, uncomment the + # next line and provide a value + # issue_tracker_url: http://example.com/issue/tracker + + # Choose a valid license ID from https://spdx.org - some suggested licenses: + # - BSD-3-Clause (default) + # - MIT + # - GPL-2.0-or-later + # - GPL-3.0-only + # - Apache-2.0 + # - CC-BY-4.0 + license: license GPL-3.0-only + + min_ansible_version: 2.10 + + # If this a Container Enabled role, provide the minimum Ansible Container version. + # min_ansible_container_version: + + # + # Provide a list of supported platforms, and for each platform a list of versions. + # If you don't wish to enumerate all versions for a particular platform, use 'all'. + # To view available platforms and versions (or releases), visit: + # https://galaxy.ansible.com/api/v1/platforms/ + # + # platforms: + # - name: Fedora + # versions: + # - all + # - 25 + # - name: SomePlatform + # versions: + # - all + # - 1.0 + # - 7 + # - 99.99 + + galaxy_tags: [] + # List tags for your role here, one per line. A tag is a keyword that describes + # and categorizes the role. Users find roles by searching for tags. Be sure to + # remove the '[]' above, if you add tags to this list. + # + # NOTE: A tag is limited to a single word comprised of alphanumeric characters. + # Maximum 20 tags per role. + +dependencies: [] + # List your role dependencies here, one per line. Be sure to remove the '[]' above, + # if you add dependencies to this list. diff --git a/webapps/jitsimeet/tasks/main.yml b/webapps/jitsimeet/tasks/main.yml new file mode 100644 index 00000000..69815e09 --- /dev/null +++ b/webapps/jitsimeet/tasks/main.yml @@ -0,0 +1,47 @@ +--- +# tasks file for jitsimeet install + +- name: Set FQDN + command: "hostnamectl set-hostname {{ domains | first }}" + +- name: Set FQDN in /etc/hosts + ansible.builtin.lineinfile: + path: /etc/hosts + line: "{{ ansible_default_ipv4.address }} {{ domains | first }}" + +# Ouvrir les ports + +- name: Add Prosody apt repository key + ansible.builtin.get_url: + url: https://prosody.im/files/prosody-debian-packages.key + dest: /etc/apt/trusted.gpg.d/prosody.gpg + mode: '0644' + force: true + +- name: Add Jitsi Meet apt repository key + ansible.builtin.get_url: + url: https://download.jitsi.org/jitsi-key.gpg.key + dest: /etc/apt/trusted.gpg.d/jitsimeet.asc + mode: '0644' + force: true + +- name: Add Prosody apt repository + ansible.builtin.apt_repository: + repo: "deb http://packages.prosody.im/debian bullseye main" + state: present + +- name: Add Jitsi Meet apt repository + ansible.builtin.apt_repository: + repo: "deb https://download.jitsi.org stable/" + state: present + +- name: Install system dependencies + ansible.builtin.apt: + name: "{{ system_dep }}" + state: present + update_cache: true + +- name: Install Jitsi Meet + ansible.builtin.apt: + name: jitsi-meet + state: present diff --git a/webapps/jitsimeet/tasks/upgrade.yml b/webapps/jitsimeet/tasks/upgrade.yml new file mode 100644 index 00000000..0b16c683 --- /dev/null +++ b/webapps/jitsimeet/tasks/upgrade.yml @@ -0,0 +1,4 @@ +--- +# tasks file for jitsimeet upgrade + + diff --git a/webapps/jitsimeet/tests/inventory b/webapps/jitsimeet/tests/inventory new file mode 100644 index 00000000..878877b0 --- /dev/null +++ b/webapps/jitsimeet/tests/inventory @@ -0,0 +1,2 @@ +localhost + diff --git a/webapps/jitsimeet/tests/test.yml b/webapps/jitsimeet/tests/test.yml new file mode 100644 index 00000000..4e019810 --- /dev/null +++ b/webapps/jitsimeet/tests/test.yml @@ -0,0 +1,5 @@ +--- +- hosts: localhost + remote_user: root + roles: + - jitsimeet diff --git a/webapps/jitsimeet/vars/main.yml b/webapps/jitsimeet/vars/main.yml new file mode 100644 index 00000000..2053e362 --- /dev/null +++ b/webapps/jitsimeet/vars/main.yml @@ -0,0 +1,2 @@ +--- +# vars file -- 2.39.2 From 3b584d19511073c03e2274c9e2bead0c2ebe3f56 Mon Sep 17 00:00:00 2001 From: Mathieu Gauthier-Pilote Date: Thu, 18 May 2023 15:51:49 -0400 Subject: [PATCH 02/28] debconf, templates, etc --- webapps/jitsimeet/defaults/main.yml | 7 +- webapps/jitsimeet/tasks/main.yml | 53 + .../templates/jicofo/logging.properties.j2 | 38 + webapps/jitsimeet/templates/meet/config.js.j2 | 1597 +++++++++++++++++ .../templates/prosody/prosody.cfg.lua.j2 | 254 +++ .../templates/prosody/virtualhost.cfg.lua.j2 | 160 ++ .../templates/videobridge/jvb.conf.j2 | 12 + .../videobridge/logging.properties.j2 | 34 + .../sip-communicator.properties.j2 | 10 + 9 files changed, 2164 insertions(+), 1 deletion(-) create mode 100644 webapps/jitsimeet/templates/jicofo/logging.properties.j2 create mode 100644 webapps/jitsimeet/templates/meet/config.js.j2 create mode 100644 webapps/jitsimeet/templates/prosody/prosody.cfg.lua.j2 create mode 100644 webapps/jitsimeet/templates/prosody/virtualhost.cfg.lua.j2 create mode 100644 webapps/jitsimeet/templates/videobridge/jvb.conf.j2 create mode 100644 webapps/jitsimeet/templates/videobridge/logging.properties.j2 create mode 100644 webapps/jitsimeet/templates/videobridge/sip-communicator.properties.j2 diff --git a/webapps/jitsimeet/defaults/main.yml b/webapps/jitsimeet/defaults/main.yml index d6813d04..b519ebcb 100644 --- a/webapps/jitsimeet/defaults/main.yml +++ b/webapps/jitsimeet/defaults/main.yml @@ -1,10 +1,15 @@ --- # defaults file for main vars -system_dep: "['gnupg2', 'curl', 'apt-transport-https', 'default-jdk', 'nginx-full', 'lua5.2']" +system_dep: "['gnupg2', 'curl', 'apt-transport-https', 'default-jdk', 'lua5.2']" domains: ['bullseye.domaine-fictif.org'] +jitsi_meet_cert_choice: "Generate a new self-signed certificate (You will later get a chance to obtain a Let's encrypt certificate)" +jitsi_meet_ssl_cert_path: "/etc/ssl/certs/ssl-cert-snakeoil.pem" +jitsi_meet_ssl_key_path: "/etc/ssl/private/ssl-cert-snakeoil.key" +jitsi_meet_turn_secret: "QZItKTo4iJ2vqrMWoZgN" + version: "stable-8319" # 7 March 2023 version_old: "stable-8252" # used by jitsimeet/tasks/upgrade.yml diff --git a/webapps/jitsimeet/tasks/main.yml b/webapps/jitsimeet/tasks/main.yml index 69815e09..1f4e383d 100644 --- a/webapps/jitsimeet/tasks/main.yml +++ b/webapps/jitsimeet/tasks/main.yml @@ -41,7 +41,60 @@ state: present update_cache: true +- name: Set debconf options for jitsi-meet + ansible.builtin.debconf: + name: "{{ item.name }}" + question: "{{ item.question }}" + value: "{{ item.value }}" + vtype: "{{ item.vtype }}" + loop: + - name: jitsi-videobridge2 + question: jitsi-videobridge/jvb-hostname + value: "{{ domains | first }}" + vtype: string + - name: jitsi-meet-web-config + question: jitsi-meet/cert-choice + value: "{{ jitsi_meet_cert_choice }}" + vtype: string + - name: jitsi-meet-web-config + question: jitsi-meet/cert-path-crt + value: "{{ jitsi_meet_ssl_cert_path }}" + vtype: string + - name: jitsi-meet-web-config + question: jitsi-meet/cert-path-key + value: "{{ jitsi_meet_ssl_key_path }}" + vtype: string + - name: jitsi-meet-prosody + question: jitsi-meet-prosody/turn-secret + value: "{{ jitsi_meet_turn_secret }}" + vtype: string + - name: Install Jitsi Meet ansible.builtin.apt: name: jitsi-meet state: present + install_recommends: no + +- name: Template config files + template: + src: "{{ item.src }}" + dest: "{{ item.dest }}" + owner: "{{ item.owner }}" + group: "{{ item.group }}" + mode: "{{ item.mode }}" + loop: + - { src: 'videobridge/jvb.conf.j2', dest: "/etc/jitsi/videobridge/jvb.conf", owner: "jvb", group: "jitsi", mode: "0640" } + - { src: 'videobridge/logging.properties.j2', dest: "/etc/jitsi/videobridge/jlogging.properties", owner: "jvb", group: "jitsi", mode: "0640" } + - { src: 'videobridge/sip-communicator.properties.j2', dest: "/etc/jitsi/videobridge/sip-communicator.properties", owner: "jvb", group: "jitsi", mode: "0640" } + - { src: 'jicofo/logging.properties.j2', dest: "/etc/jitsi/jicofo/logging.properties", owner: "jicofo", group: "jitsi", mode: "0640" } + - { src: 'meet/config.js.j2', dest: "/etc/jitsi/meet/{{ domains | first }}-config.js", owner: "root", group: "root", mode: "0644" } + - { src: 'prosody/prosody.cfg.lua.j2', dest: "/etc/prosody/prosody.cfg.lua", owner: "root", group: "prosody", mode: "0640" } + - { src: 'prosody/virtualhost.cfg.lua.j2', dest: "/etc/prosody/conf.avail/{{ domains | first }}.cfg.lua", owner: "root", group: "root", mode: "0644" } + +#- name: Install Jitsi Meet +# ansible.builtin.apt: +# name: +# - nginx-full +# - python3-certbot-nginx +# state: present +# install_recommends: no diff --git a/webapps/jitsimeet/templates/jicofo/logging.properties.j2 b/webapps/jitsimeet/templates/jicofo/logging.properties.j2 new file mode 100644 index 00000000..7181e262 --- /dev/null +++ b/webapps/jitsimeet/templates/jicofo/logging.properties.j2 @@ -0,0 +1,38 @@ + +handlers= java.util.logging.ConsoleHandler + +# Handlers with XMPP debug enabled: +#handlers= java.util.logging.ConsoleHandler, org.jitsi.impl.protocol.xmpp.log.XmppPacketsFileHandler + +# Handlers with syslog enabled: +#handlers= java.util.logging.ConsoleHandler, com.agafua.syslog.SyslogHandler +#handlers= java.util.logging.ConsoleHandler, io.sentry.jul.SentryHandler + +java.util.logging.ConsoleHandler.level = ALL +java.util.logging.ConsoleHandler.formatter = org.jitsi.utils.logging2.JitsiLogFormatter +java.util.logging.ConsoleHandler.filter = org.jitsi.impl.protocol.xmpp.log.ExcludeXmppPackets + +org.jitsi.utils.logging2.JitsiLogFormatter.programname=Jicofo +.level=INFO + +# To enable XMPP packets logging add XmppPacketsFileHandler to the handlers property +org.jitsi.impl.protocol.xmpp.log.PacketDebugger.level=ALL +org.jitsi.impl.protocol.xmpp.log.XmppPacketsFileHandler.pattern=/var/log/jitsi/jicofo-xmpp.log +org.jitsi.impl.protocol.xmpp.log.XmppPacketsFileHandler.append=true +org.jitsi.impl.protocol.xmpp.log.XmppPacketsFileHandler.limit=200000000 +org.jitsi.impl.protocol.xmpp.log.XmppPacketsFileHandler.count=3 + +# Syslog (uncomment handler to use) +com.agafua.syslog.SyslogHandler.transport = udp +com.agafua.syslog.SyslogHandler.facility = local0 +com.agafua.syslog.SyslogHandler.port = 514 +com.agafua.syslog.SyslogHandler.hostname = localhost +com.agafua.syslog.SyslogHandler.formatter = org.jitsi.utils.logging2.JitsiLogFormatter +com.agafua.syslog.SyslogHandler.escapeNewlines = false +com.agafua.syslog.SyslogHandler.filter = org.jitsi.impl.protocol.xmpp.log.ExcludeXmppPackets + +# Sentry (uncomment handler to use) +io.sentry.jul.SentryHandler.level=WARNING + +# uncomment to see how Jicofo talks to the JVB +#org.jitsi.impl.protocol.xmpp.colibri.level=ALL diff --git a/webapps/jitsimeet/templates/meet/config.js.j2 b/webapps/jitsimeet/templates/meet/config.js.j2 new file mode 100644 index 00000000..1f4473e3 --- /dev/null +++ b/webapps/jitsimeet/templates/meet/config.js.j2 @@ -0,0 +1,1597 @@ +/* eslint-disable comma-dangle, no-unused-vars, no-var, prefer-template, vars-on-top */ + +/* + * NOTE: If you add a new option please remember to document it here: + * https://jitsi.github.io/handbook/docs/dev-guide/dev-guide-configuration + */ + +var subdir = ''; +var subdomain = ''; + +if (subdomain) { + subdomain = subdomain.substr(0, subdomain.length - 1).split('.') + .join('_') + .toLowerCase() + '.'; +} + +// In case of no ssi provided by the webserver, use empty strings +if (subdir.startsWith('