Page MenuHomePhabricator

Make it easier to set up a simple wiki farm in MediaWiki-Docker
Open, Needs TriagePublic

Description

I just went through the process of setting up a simple two-wiki wikifarm in MediaWiki-Docker. While not terribly difficult, it's still much more difficult than just the basic MW-Docker setup, as it requires a few image customizations, as well as non-obvious LocalSettings changes. See https://www.mediawiki.org/wiki/MediaWiki-Docker/Configuration_recipes/Wiki_farm for an example guide (which can surely be improved a lot, but still). It would be great if there was a simpler way to do this, e.g. by setting a certain flag in .env.

Event Timeline

BPirkle subscribed.

Tagging MW Engineering for visibility. Not promising this will be picked up, but we'll at least triage it.

It would be nice to make this a little more complicated and include CentralAuth in whatever documentation/tooling we create, because that is a pretty common use case for setting up a multi-wiki setup in a local development environment.

It would be nice to make this a little more complicated and include CentralAuth in whatever documentation/tooling we create, because that is a pretty common use case for setting up a multi-wiki setup in a local development environment.

Agreed, but I think 90% of the complexity lies in setting up a wiki farm. My team recently had a couple sessions where we went through the creation of a wiki farm with CentralAuth enabled, and most time was spent creating the wiki farm. The notes from those sessions were eventually turned into the configuration recipe I linked above. For CentralAuth you can mostly just follow the steps in https://www.mediawiki.org/wiki/Extension:CentralAuth#Installation and it'll work. There's also https://www.mediawiki.org/wiki/MediaWiki-Docker/Extension/CentralAuth, which I think could be simplified.

I think there is three parts to this:

  1. Generating the configuration for the additional wiki. With the new configuration system, this should now be easy enough, see https://www.mediawiki.org/wiki/MediaWiki_1.38/New_configuration_system#Configuring_wiki_farms. I think I have an old exeprimental patch for that somewhere.
  2. Running the relevant installer code for creating and initializing the new wiki's database. @tstarling has recently worked on this.
  3. Add a hostname entry for accessing thew new wiki. This is very much dependent on the operating system / environment.

I think 1) and 2) should be done by the installer, but it needs quite a bit of refactoring. It would probably involve making better use of SettingsBuilder.