Files
kevinveenbirkenbachandClaude Opus 5.5 b83b361ea9 fix(web-app-bigbluebutton): run BBB v3.0.39 with the shared-notes server
The version-source update in #1146 moved the bigbluebutton/docker ref from
v3.0.23 to v3.0.39. That tag changes three things the role did not
handle, and it exposed a fourth defect in compose_file_args.

1. generate-compose renders etherpad and bbb-pads only behind
   USE_INSECURE_ETHERPAD and otherwise emits bbb-shared-notes-server with
   a `build:` block and no `image:` (upstream adds the image only after
   the tag, in 9a6a9a9a4c). compose_mods drops `build` only where an image
   is set, so the guard "Fail if any service still builds locally" stopped
   every BigBlueButton deploy (main run 39749899667, Nextcloud#11:
   `rc: 0`, `stdout: '    build:'`, bootstrap_compose_project.yml:35).
   meta/services.yml now pins alangecker/bbb-shared-notes-server:v3.0.39,
   compose_mods takes `pinned` (BBB_PINNED_SERVICES, every service the
   role config pins an image for) and drops their `build`, and the
   etherpad leftovers go (ep_redis_publisher patch, etherpad postgres
   entrypoint and initdb hook, etherpad database tasks, ETHERPAD_* env,
   etherpad_api_key secret).

2. The notes server connects to postgres once at start and exits with 2
   when it is not up yet; upstream gives it no restart policy. The
   override sets the role's restart policy, so it retries until postgres
   accepts connections.

3. Greenlight moves from v3.8.0 to v3.9.0.1, which sets
   `config.hosts = URL_HOST`, and the template passes
   `URL_HOST: https://${DOMAIN}`. Rails compares hostnames, so every
   request was blocked (`Blocked hosts: bbb.talk.infinito.test`, 403).
   Greenlight documents URL_HOST as the bare hostname; the override sets
   it to the role domain.

4. compose_file_args decided whether a role ships a compose override by
   templating "{{ application_id | abs_role_path_by_application_id }}"
   through the templar. ansible-core 2.21 does not render an untrusted
   string, so the check saw the literal and always returned False: the CA
   override generation and the pull handler never read BBB's
   compose.override.yml. That was harmless while compose.yml alone was
   valid; with the notes-server image living in the override, `compose
   config` failed ("has neither an image nor a build context"). The check
   now resolves the role path for the application id it is given. BBB is
   the only role that ships an override, so no other role's file list
   changes.

Existing installations drop the etherpad and bbb-pads containers on the
next `compose up --remove-orphans`; the old `etherpad` database stays in
PostgreSQL untouched.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-22 16:56:48 +02:00

139 lines
3.7 KiB
Django/Jinja

{% include 'roles/sys-svc-container/templates/env.j2' %}
{# nocheck: comments-valid - upstream BigBlueButton sample.env; all inline docs intentional #}
ENABLE_COTURN={{ BBB_COTURN_LOCAL_ENABLED | lower }}
ENABLE_COLLABORA={{ BBB_COLLABORA_ENABLED | lower }}
COLLABORA_URL={{ BBB_COLLABORA_URL }}
{% if lookup('tls', application_id, 'enabled') | bool %}
COTURN_TLS_CERT_PATH={{ BBB_COTURN_TLS_CERT_PATH }}
COTURN_TLS_KEY_PATH={{ BBB_COTURN_TLS_KEY_PATH }}
{% endif %}
ENABLE_GREENLIGHT={{ BBB_GREENLIGHT_ENABLED | lower }}
{% if lookup('config', application_id, 'services.prometheus.enabled') | bool %}
ENABLE_PROMETHEUS_EXPORTER=true
ENABLE_PROMETHEUS_EXPORTER_OPTIMIZATION=true
{% endif %}
ENABLE_RECORDING={{ BBB_RECORDING_ENABLED | lower }}
REMOVE_OLD_RECORDING={{ BBB_RECORDING_CLEANUP_ENABLED | lower }}
RECORDING_MAX_AGE_DAYS={{ BBB_RECORDING_MAX_AGE_DAYS }}
SHARED_SECRET={{ BBB_SHARED_SECRET }}
RAILS_SECRET={{ BBB_RAILS_SECRET }}
POSTGRESQL_SECRET={{ BBB_POSTGRESQL_SECRET }}
FSESL_PASSWORD={{ BBB_FSESL_PASSWORD | dotenv_quote }}
DOMAIN={{ domain }}
EXTERNAL_IPv4={{ networks.internet.ip4 }}
{% if BBB_IP6_ENABLED | bool %}
EXTERNAL_IPv6={{ networks.internet.ip6 }}
{% endif %}
STUN_IP={{ BBB_TURN_DOMAIN }}
STUN_PORT={{ BBB_STUN_PORT }}
TURN_SERVER={{ BBB_TURN_PROTOCOL }}:{{ BBB_TURN_DOMAIN }}:{{ BBB_TURN_PORT }}?transport=tcp
TURN_SECRET={{ BBB_TURN_SECRET }}
SIP_IP_ALLOWLIST=
CLIENT_TITLE=BigBlueButton
WELCOME_MESSAGE=Welcome to <b>%%CONFNAME%%</b>!<br><br>For help on using BigBlueButton see the <a href='https://docs.bigbluebutton.org/' target='_blank'><u>documentation</u></a>.<br><br>To join the audio bridge click the speaker button. Use a headset to avoid causing background noise for others.
WELCOME_FOOTER=This server is running <a href='https://docs.bigbluebutton.org/'' target='_blank'><u>BigBlueButton</u></a>.
DEFAULT_PRESENTATION=./mod/nginx/default.pdf
SOUNDS_LANGUAGE=en-us-callie
LISTEN_ONLY_MODE=true
DISABLE_ECHO_TEST=false
AUTO_SHARE_WEBCAM=false
DISABLE_VIDEO_PREVIEW=false
CHAT_ENABLED=true
CHAT_START_CLOSED=false
DISABLE_SOUND_MUTED=false
DISABLE_SOUND_ALONE=false
BREAKOUTROOM_LIMIT=8
ENABLE_LEARNING_DASHBOARD=true
NUMBER_OF_BACKEND_NODEJS_PROCESSES=2
NUMBER_OF_FRONTEND_NODEJS_PROCESSES=2
OFFICE365_KEY=
OFFICE365_SECRET=
OFFICE365_HD=
OAUTH2_REDIRECT=
{% if BBB_LDAP_ENABLED | bool %}
LDAP_SERVER={{ LDAP.SERVER.DOMAIN }}
LDAP_PORT={{ LDAP.SERVER.PORT }}
LDAP_UID={{ LDAP.USER.ATTRIBUTES.ID }}
LDAP_BASE={{ LDAP.DN.ROOT }}
LDAP_BIND_DN={{ LDAP.DN.ADMINISTRATOR.DATA }}
LDAP_AUTH=password
LDAP_PASSWORD={{ LDAP.BIND_CREDENTIAL | dotenv_quote }}
{% endif %}
ALLOW_GREENLIGHT_ACCOUNTS=true
{% set email = lookup('email', application_id) %}
{% if email.enabled | bool %}
SMTP_SERVER={{ email.host }}
SMTP_DOMAIN={{ email.domain }}
SMTP_PORT={{ email.port }}
SMTP_USERNAME={{ email.username }}
SMTP_PASSWORD={{ email.password | dotenv_quote }}
SMTP_AUTH=plain
SMTP_OPENSSL_VERIFY_MODE=none
SMTP_STARTTLS_AUTO={{ email.start_tls | lower }}
SMTP_STARTTLS={{ email.start_tls | lower }}
SMTP_TLS={{ email.tls | lower }}
SMTP_SSL_VERIFY=true
SMTP_SENDER={{ email['from'] }}
SMTP_SENDER_EMAIL={{ email['from'] }}
{% endif %}
RELATIVE_URL_ROOT=/b
ROOM_FEATURES=mute-on-join,require-moderator-approval,anyone-can-start,all-join-moderator
PAGINATION_NUMBER=25
NUMBER_OF_ROWS=25
ENABLE_GOOGLE_CALENDAR_BUTTON=
MAINTENANCE_MODE=false
MAINTENANCE_WINDOW=
HELP_URL=https://docs.bigbluebutton.org/greenlight/v3/install/
DEFAULT_REGISTRATION=invite
{% if BBB_OIDC_ENABLED | bool %}
OPENID_CONNECT_CLIENT_ID={{ OIDC.CLIENT.ID }}
OPENID_CONNECT_CLIENT_SECRET={{ OIDC.CLIENT.SECRET }}
OPENID_CONNECT_ISSUER={{ OIDC.CLIENT.ISSUER_URL }}
OPENID_CONNECT_REDIRECT={{ lookup('tls', application_id, 'url.base') }}
{% endif %}