Remove the concept of worker "types"

[anoadragon453]

We're currently midway through the process of fading out the concept of different types for a Synapse worker process. For example synapse.app.pusher, synapse.app.federation_sender etc. While initially this provided a quick way to configure a worker to perform certain actions, it is also rather confusing and the inability to specify multiple types per worker can limit the flexibility of deployment.

For instance, it's currently not possible to configure a worker to both send events to appservices (synapse.app.appservice) and update the user directory tables (synapse.app.user_dir), as the functionality is forcefully disabled unless the worker is specifically marked as each respective type:

https://github.com/matrix-org/synapse/blob/85d237eba789a667109ced140026d2494b210310/synapse/app/generic_worker.py#L433-L463

Instead, workers should be configured via worker file config options, so that one could simply set notify_appservices: true and update_user_directory: true in the worker config to enable the worker to handle both sets of tasks.

As many worker deployments currently rely on the worker_type configuration, a deprecation period is necessary. A rough plan for carrying this out could look like:

• Allow all current worker configurations through config file values alone.
• Announce a deprecation period for the worker_type config option.
• After some time, remove the worker_type config option. All workers are now a "generic worker", though this term is no longer a necessary distinction.

In the short term, the first step would allow for more immediate flexibility for medium-sized deployments - which need to move tasks off the main process, but don't have the resources to spin up a separate worker for each type.

Superseded worker types so far

• [x] synapse.app.appservice #12452
• [x] synapse.app.user_dir #12654
• [ ] synapse.app.pusher
• [ ] synapse.app.federation_sender
• [ ] synapse.app.media_repository
• [ ] synapse.app.frontend_proxy

[anoadragon453]

One small thinko for the first step was how we'd be able to keep the current functionality of warning the user that both the worker and main process was configured for the same purpose. This is necessary if you need a task to run on at max one worker process. We currently use a combination of the worker type (i.e synapse.app.appservice) and config options (notify_appservices), and we'd like to remove the former.

We already have a solution to this: simply add a config option for specify the name of the worker that should handle the task. As an example, run_background_tasks_on: <worker_name>.

[richvdh]

frontend_proxy is already totally redundant: there is no difference between it and generic_worker. The only thing left is to remove it from the documentation, which I hope #13451 will do.

I also think synapse.app.pusher is superceded by pusher_instances (#9466), but again it needs documenting properly.