matrix-docker-ansible-deploy/docs
Slavi Pantaleev c10182e5a6 Make roles more independent of one another
With this change, the following roles are now only dependent
on the minimal `matrix-base` role:
- `matrix-corporal`
- `matrix-coturn`
- `matrix-mailer`
- `matrix-mxisd`
- `matrix-postgres`
- `matrix-riot-web`
- `matrix-synapse`

The `matrix-nginx-proxy` role still does too much and remains
dependent on the others.

Wiring up the various (now-independent) roles happens
via a glue variables file (`group_vars/matrix-servers`).
It's triggered for all hosts in the `matrix-servers` group.

According to Ansible's rules of priority, we have the following
chain of inclusion/overriding now:
- role defaults (mostly empty or good for independent usage)
- playbook glue variables (`group_vars/matrix-servers`)
- inventory host variables (`inventory/host_vars/matrix.<your-domain>`)

All roles default to enabling their main component
(e.g. `matrix_mxisd_enabled: true`, `matrix_riot_web_enabled: true`).
Reasoning: if a role is included in a playbook (especially separately,
in another playbook), it should "work" by default.

Our playbook disables some of those if they are not generally useful
(e.g. `matrix_corporal_enabled: false`).
2019-01-16 18:05:48 +02:00
..
ansible.md Add Ansible guide and Ansible version checks 2019-01-03 16:24:14 +02:00
configuring-dns.md Use CNAME for riot in the example table 2018-10-21 16:34:00 +03:00
configuring-playbook-bridge-mautrix-telegram.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-bridge-mautrix-whatsapp.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-email.md Update documentation about email configuration (relayhost brackets) 2018-12-13 16:32:10 +09:00
configuring-playbook-external-postgres.md Make roles more independent of one another 2019-01-16 18:05:48 +02:00
configuring-playbook-federation.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-ldap-auth.md Add LDAP auth password provider documentation and changelog description 2018-11-28 11:21:03 +02:00
configuring-playbook-matrix-corporal.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-mxisd.md Split playbook into multiple roles 2019-01-12 18:01:10 +02:00
configuring-playbook-own-webserver.md Add support for 2 more SSL certificate retrieval methods 2018-12-23 11:00:12 +02:00
configuring-playbook-rest-auth.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-s3.md Improve wording a bit 2018-08-08 10:10:16 +03:00
configuring-playbook-shared-secret-auth.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook-ssl-certificates.md Add support for 2 more SSL certificate retrieval methods 2018-12-23 11:00:12 +02:00
configuring-playbook-telemetry.md Annotate certain features as optional/advanced 2018-11-26 07:23:42 +02:00
configuring-playbook.md Split playbook into multiple roles 2019-01-12 18:01:10 +02:00
configuring-well-known.md Fix /.well-known/matrix/client for CORS 2018-11-29 09:13:25 +02:00
importing-media-store.md Make media-store restore work with server files, not local 2019-01-01 15:57:50 +02:00
importing-postgres.md Make media-store restore work with server files, not local 2019-01-01 15:57:50 +02:00
importing-sqlite.md Make media-store restore work with server files, not local 2019-01-01 15:57:50 +02:00
installing.md Make media-store restore work with server files, not local 2019-01-01 15:57:50 +02:00
maintenance-and-troubleshooting.md Add initial version of maintenance and troubleshooting doc 2018-11-14 14:34:24 -06:00
maintenance-checking-services.md Add self-check command 2018-10-21 12:58:25 +03:00
maintenance-upgrading-postgres.md Add support for configuring Postgres auto-upgrade-backup path 2018-11-01 09:48:56 +02:00
maintenance-upgrading-services.md Link to Synapse Homeowners room 2018-12-11 10:15:09 -06:00
prerequisites.md Add Ansible guide and Ansible version checks 2019-01-03 16:24:14 +02:00
README.md Add initial version of maintenance and troubleshooting doc 2018-11-14 14:34:24 -06:00
registering-users.md add script + doc to change a user to admin 2018-11-28 11:02:15 +01:00
uninstalling.md add script + doc to remove everything 2018-11-28 11:02:51 +01:00