BigBlueButton Architecture¶
Compose 🐳¶
flowchart LR
subgraph role [web-app-bigbluebutton]
svc_bbb_web["bbb-web<br>alangecker/bbb-docker-web:v3.0.39"]
svc_freeswitch["freeswitch<br>alangecker/bbb-docker-freeswitch:v1.11.3-v3.0.39"]
svc_nginx["nginx<br>alangecker/bbb-docker-nginx:v3.0.39-v5.4.8-1.29"]
svc_bbb_shared_notes_server["bbb-shared-notes-server<br>alangecker/bbb-shared-notes-server:v3.0.39"]
svc_bbb_export_annotations["bbb-export-annotations<br>alangecker/bbb-docker-bbb-export-annotations:v3.0.39"]
svc_fsesl_akka["fsesl-akka<br>alangecker/bbb-docker-fsesl-akka:v3.0.39"]
svc_apps_akka["apps-akka<br>alangecker/bbb-docker-apps-akka:v3.0.39"]
svc_bbb_graphql_server["bbb-graphql-server<br>alangecker/bbb-docker-graphql-server:v3.0.39"]
svc_bbb_graphql_actions["bbb-graphql-actions<br>alangecker/bbb-docker-graphql-actions:v3.0.39"]
svc_bbb_graphql_middleware["bbb-graphql-middleware<br>alangecker/bbb-docker-graphql-middleware:v3.0.39"]
svc_periodic["periodic<br>alangecker/bbb-docker-periodic:v3.0.0"]
svc_redis["redis<br>built here"]
svc_postgres["postgres<br>built here"]
svc_prometheus_exporter["prometheus-exporter<br>built here"]
svc_greenlight["greenlight<br>built here"]
svc_recordings["recordings<br>alangecker/bbb-docker-recordings:v3.0.39"]
svc_bbb_webrtc_recorder["bbb-webrtc-recorder<br>alangecker/bbb-docker-webrtc-recorder:v0.14.0"]
svc_webrtc_sfu["webrtc-sfu<br>alangecker/bbb-docker-webrtc-sfu:v2.24.0"]
svc_coturn["coturn<br>built here"]
end
Swarm 🐝¶
flowchart LR
svc_bbb_web["bbb-web"]
svc_bbb_web --> rep_bbb_web["replicas: from the host group"]
svc_freeswitch["freeswitch"]
svc_freeswitch --> rep_freeswitch["replicas: from the host group"]
svc_nginx["nginx"]
svc_nginx --> rep_nginx["replicas: from the host group"]
svc_bbb_shared_notes_server["bbb-shared-notes-server"]
svc_bbb_shared_notes_server --> rep_bbb_shared_notes_server["replicas: from the host group"]
svc_bbb_export_annotations["bbb-export-annotations"]
svc_bbb_export_annotations --> rep_bbb_export_annotations["replicas: from the host group"]
svc_fsesl_akka["fsesl-akka"]
svc_fsesl_akka --> rep_fsesl_akka["replicas: from the host group"]
svc_apps_akka["apps-akka"]
svc_apps_akka --> rep_apps_akka["replicas: from the host group"]
svc_bbb_graphql_server["bbb-graphql-server"]
svc_bbb_graphql_server --> rep_bbb_graphql_server["replicas: from the host group"]
svc_bbb_graphql_actions["bbb-graphql-actions"]
svc_bbb_graphql_actions --> rep_bbb_graphql_actions["replicas: from the host group"]
svc_bbb_graphql_middleware["bbb-graphql-middleware"]
svc_bbb_graphql_middleware --> rep_bbb_graphql_middleware["replicas: from the host group"]
svc_periodic["periodic"]
svc_periodic --> rep_periodic["replicas: from the host group"]
svc_redis["redis"]
svc_redis --> rep_redis["replicas: from the host group"]
svc_postgres["postgres"]
svc_postgres --> rep_postgres["replicas: from the host group"]
svc_prometheus_exporter["prometheus-exporter"]
svc_prometheus_exporter --> rep_prometheus_exporter["replicas: from the host group"]
svc_greenlight["greenlight"]
svc_greenlight --> rep_greenlight["replicas: from the host group"]
svc_recordings["recordings"]
svc_recordings --> rep_recordings["replicas: from the host group"]
svc_bbb_webrtc_recorder["bbb-webrtc-recorder"]
svc_bbb_webrtc_recorder --> rep_bbb_webrtc_recorder["replicas: from the host group"]
svc_webrtc_sfu["webrtc-sfu"]
svc_webrtc_sfu --> rep_webrtc_sfu["replicas: from the host group"]
svc_coturn["coturn"]
svc_coturn --> rep_coturn["replicas: from the host group"]
classDef pinned fill:#fef7e0,stroke:#b06000,color:#3d2600;
Volumes¶
flowchart LR
vol_bigbluebutton["bigbluebutton_bigbluebutton"]
vol_bigbluebutton -->|"swarm + storage.backend nfs"| nfs_bigbluebutton["shared over NFS"]:::shared
vol_bigbluebutton -->|"compose, or backend local"| cl_bigbluebutton["node-local"]:::local
vol_freeswitch["bigbluebutton_freeswitch"]
vol_freeswitch -->|"swarm + storage.backend nfs"| nfs_freeswitch["shared over NFS"]:::shared
vol_freeswitch -->|"compose, or backend local"| cl_freeswitch["node-local"]:::local
vol_mediasoup["bigbluebutton_mediasoup"]
vol_mediasoup -->|"swarm + storage.backend nfs"| nfs_mediasoup["shared over NFS"]:::shared
vol_mediasoup -->|"compose, or backend local"| cl_mediasoup["node-local"]:::local
vol_redis["bigbluebutton_redis"]
vol_redis -->|"swarm + storage.backend nfs"| nfs_redis["shared over NFS"]:::shared
vol_redis -->|"compose, or backend local"| cl_redis["node-local"]:::local
vol_database["bigbluebutton_database"]
vol_database -->|"swarm + storage.backend nfs"| nfs_database["shared over NFS"]:::shared
vol_database -->|"compose, or backend local"| cl_database["node-local"]:::local
vol_greenlight["bigbluebutton_greenlight"]
vol_greenlight -->|"swarm + storage.backend nfs"| nfs_greenlight["shared over NFS"]:::shared
vol_greenlight -->|"compose, or backend local"| cl_greenlight["node-local"]:::local
vol_coturn["bigbluebutton_coturn"]
vol_coturn -->|"swarm + storage.backend nfs"| nfs_coturn["shared over NFS"]:::shared
vol_coturn -->|"compose, or backend local"| cl_coturn["node-local"]:::local
classDef shared fill:#e6f4ea,stroke:#137333,color:#0b2e13;
classDef local fill:#fef7e0,stroke:#b06000,color:#3d2600;
Condition |
Effect |
|---|---|
swarm, |
shared over NFS |
any one of those missing |
node-local |
All four conditions must hold, so pinning a role takes every one of its volumes node-local. Only the role’s primary entry counts as pinned here: a placement on any other service pins that service alone and leaves the backing of every volume unchanged. The chain is drawn rather than its result, because that coupling is what makes a placement change move data without saying so.
Dependencies¶
flowchart LR
subgraph deps [Dependencies]
dep_svc_bkp_volume_2_local["svc-bkp-volume-2-local 💻"]
dep_svc_db_openldap["svc-db-openldap 🐳🐝"]
dep_web_app_dashboard["web-app-dashboard 🐳🐝"]
dep_web_app_docs["web-app-docs 🐳🐝"]
dep_web_app_keycloak["web-app-keycloak 🐳🐝"]
dep_web_app_matomo["web-app-matomo 🐳🐝"]
dep_web_app_prometheus["web-app-prometheus 🐳🐝"]
dep_web_app_stalwart["web-app-stalwart 🐳🐝"]
dep_web_svc_collabora["web-svc-collabora 🐳🐝"]
dep_web_svc_coturn["web-svc-coturn 🐳🐝"]
dep_web_svc_design["web-svc-design 💻"]
dep_web_svc_logout["web-svc-logout 🐳🐝"]
end
subgraph role [web-app-bigbluebutton 🐳🐝]
svc_sso["sso"]
svc_logout["logout"]
svc_ldap["ldap"]
svc_dashboard["dashboard"]
svc_matomo["matomo"]
svc_email["email"]
svc_bigbluebutton["bigbluebutton"]
svc_postgres["postgres"]
svc_greenlight["greenlight"]
svc_coturn["coturn"]
svc_collabora["collabora"]
svc_design["design"]
svc_prometheus["prometheus"]
svc_bbb_web["bbb-web"]
svc_freeswitch["freeswitch"]
svc_nginx["nginx"]
svc_bbb_shared_notes_server["bbb-shared-notes-server"]
svc_bbb_export_annotations["bbb-export-annotations"]
svc_webrtc_sfu["webrtc-sfu"]
svc_fsesl_akka["fsesl-akka"]
svc_apps_akka["apps-akka"]
svc_bbb_graphql_server["bbb-graphql-server"]
svc_bbb_graphql_actions["bbb-graphql-actions"]
svc_bbb_graphql_middleware["bbb-graphql-middleware"]
svc_periodic["periodic"]
svc_recordings["recordings"]
svc_bbb_webrtc_recorder["bbb-webrtc-recorder"]
svc_dockerize["dockerize"]
svc_container_backup["container_backup"]
svc_tor["tor ❌"]
svc_docs["docs"]
end
subgraph dependents [Dependents]
dpt_web_app_discourse["web-app-discourse 🐳🐝"]
dpt_web_app_moodle["web-app-moodle 🐳🐝"]
dpt_web_app_nextcloud["web-app-nextcloud 🐳🐝"]
dpt_web_app_wordpress["web-app-wordpress 🐳🐝"]
end
dep_svc_bkp_volume_2_local -. "0..1" .-> svc_container_backup
dep_svc_db_openldap -- "1:1" --> svc_ldap
dep_web_app_dashboard -. "0..1" .-> svc_dashboard
dep_web_app_docs -. "0..1" .-> svc_docs
dep_web_app_keycloak -. "0..1" .-> svc_sso
dep_web_app_matomo -. "0..1" .-> svc_matomo
dep_web_app_prometheus -. "0..1" .-> svc_prometheus
dep_web_app_stalwart -. "0..1" .-> svc_email
dep_web_svc_collabora -. "0..1" .-> svc_collabora
dep_web_svc_coturn -. "0..1" .-> svc_coturn
dep_web_svc_design -. "0..1" .-> svc_design
dep_web_svc_logout -. "0..1" .-> svc_logout
svc_sso -. "0..1" .-> dpt_web_app_discourse
svc_sso -. "0..1" .-> dpt_web_app_moodle
svc_sso -. "0..1" .-> dpt_web_app_nextcloud
svc_sso -. "0..1" .-> dpt_web_app_wordpress
Symbol |
Meaning |
|---|---|
|
fixed relationship |
|
conditional, enabled only in matching deployments |
|
declared but turned off in this role |
💻 |
deploys to the host |
🐳 |
deploys under compose |
🐝 |
deploys under swarm |
❌ |
service explicitly turned off |
⚙️ |
Ansible role dependency from |
Every dependency and dependent is listed; the graph is not truncated.