MediaWiki SaaS - Revision history

Dereckson at 16:02, 12 October 2025

2025-10-12T16:02:10Z

@@ Line 41: / Line 41: @@
 ** Edit the saas-mediawiki config/Settings.php folder, saasUseExtensionFoo will load the Foo extension and saasUseSkinBar will load the bar skin.
 ** If you need more advanced logic, config/CommonsSettings.php contain a good example for Scribunto
 == How to run a script against a wiki? ==

Dereckson: /* How to lock a wiki in read-only mode? */

2025-10-12T15:39:54Z

How to lock a wiki in read-only mode?

← Older revision		Revision as of 15:39, 12 October 2025
Line 54:		Line 54:
	An example can be found at [https://devcentral.nasqueron.org/D3743 D3743].		An example can be found at [https://devcentral.nasqueron.org/D3743 D3743].

	~~Once done~~, simply revert it the change.		If the lock is for a maintenance, commit it so we've a trace, then simply revert the change when the maintenance is done.

Dereckson at 15:39, 12 October 2025

2025-10-12T15:39:13Z

← Older revision		Revision as of 15:39, 12 October 2025
Line 47:		Line 47:

	For example <kbd>sudo -u mediawiki mw update agora</kbd> will run update.php for this wiki.		For example <kbd>sudo -u mediawiki mw update agora</kbd> will run update.php for this wiki.

			== How to lock a wiki in read-only mode? ==

			Set saasReadOnly to Some("Your explanation message").

			An example can be found at [https://devcentral.nasqueron.org/D3743 D3743].

			Once done, simply revert it the change.

Dereckson: /* How to add a wiki? */

2024-11-17T23:39:47Z

How to add a wiki?

← Older revision		Revision as of 23:39, 17 November 2024
Line 23:		Line 23:
	## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section		## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section
	# Deploy operations changes with Salt		# Deploy operations changes with Salt
	## '''Nginx vhost.''' <code>salt-call --local state.sls roles/webserver-legacy/nginx`</code> or sometimes saas-mediawiki/nginx instead		## '''Nginx vhost.''' <code>salt-call --local state.sls roles/webserver-legacy/nginx</code> or sometimes saas-mediawiki/nginx instead
	## '''Datastores.''' <code>salt-call --local state.sls roles/saas-mediawiki/data`</code>		## '''Datastores.''' <code>salt-call --local state.sls roles/saas-mediawiki/data</code>
	# Declare the dbname/host name pair for the new instance in the configuration		# Declare the dbname/host name pair for the new instance in the configuration
	# Create a database		# Create a database

Dereckson: /* How to run a script against a wiki? */

2022-01-23T17:25:13Z

How to run a script against a wiki?

← Older revision		Revision as of 17:25, 23 January 2022
Line 44:		Line 44:
	== How to run a script against a wiki? ==		== How to run a script against a wiki? ==

	The <code>mw</code> command allow to run a maintenance script to a specific wiki.		The <code>mw <script to run> <wiki name></code> command allow to run a maintenance script to a specific wiki.

	For example <kbd>sudo -u mediawiki mw agora ~~update~~</kbd> will run update.php for this wiki.		For example <kbd>sudo -u mediawiki mw update agora</kbd> will run update.php for this wiki.

Dereckson: /* How to add a wiki? */

2020-03-05T01:16:32Z

How to add a wiki?

← Older revision		Revision as of 01:16, 5 March 2020
Line 17:		Line 17:

	== How to add a wiki? ==		== How to add a wiki? ==


	# DNS: <your domain> CNAME saas-mediawiki.nasqueron.org		# DNS: <your domain> CNAME saas-mediawiki.nasqueron.org
Line 23:		Line 22:
	## nginx: add your server block to the webserver-legacy role, you need to use <code>include includes/mediawiki-root</code> to serve /Article pages, or <code>include includes/mediawiki-wiki</code> to serve /wiki/Article pages (useful if you've other services than a wiki on this domain)		## nginx: add your server block to the webserver-legacy role, you need to use <code>include includes/mediawiki-root</code> to serve /Article pages, or <code>include includes/mediawiki-wiki</code> to serve /wiki/Article pages (useful if you've other services than a wiki on this domain)
	## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section		## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section
			# Deploy operations changes with Salt
			## '''Nginx vhost.''' <code>salt-call --local state.sls roles/webserver-legacy/nginx`</code> or sometimes saas-mediawiki/nginx instead
			## '''Datastores.''' <code>salt-call --local state.sls roles/saas-mediawiki/data`</code>
	# Declare the dbname/host name pair for the new instance in the configuration		# Declare the dbname/host name pair for the new instance in the configuration
	# Create a database		# Create a database
Line 28:		Line 30:
	## If you migrate an existing wiki from its db: <kbd>mysql yourwiki < dump.sql</kbd> + <kbd>mw update yourwiki</kbd> works well		## If you migrate an existing wiki from its db: <kbd>mysql yourwiki < dump.sql</kbd> + <kbd>mw update yourwiki</kbd> works well
	## If it's a fresh new wiki: <kbd>mw addWiki yourwiki</kbd> will create the database and populate the tables		## If it's a fresh new wiki: <kbd>mw addWiki yourwiki</kbd> will create the database and populate the tables

			To deploy changes with Salt

	== How to deploy an extension or a skin? ==		== How to deploy an extension or a skin? ==

Dereckson: /* How to add a wiki? */

2018-04-01T01:53:21Z

How to add a wiki?

← Older revision		Revision as of 01:53, 1 April 2018
Line 17:		Line 17:

	== How to add a wiki? ==		== How to add a wiki? ==


	# DNS: <your domain> CNAME saas-mediawiki.nasqueron.org		# DNS: <your domain> CNAME saas-mediawiki.nasqueron.org
Line 22:		Line 23:
	## nginx: add your server block to the webserver-legacy role, you need to use <code>include includes/mediawiki-root</code> to serve /Article pages, or <code>include includes/mediawiki-wiki</code> to serve /wiki/Article pages (useful if you've other services than a wiki on this domain)		## nginx: add your server block to the webserver-legacy role, you need to use <code>include includes/mediawiki-root</code> to serve /Article pages, or <code>include includes/mediawiki-wiki</code> to serve /wiki/Article pages (useful if you've other services than a wiki on this domain)
	## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section		## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section
			# Declare the dbname/host name pair for the new instance in the configuration
			# Create a database
			## In every case, <kbd>GRANT ALL PRIVILEGES on wikis.* TO 'mediawiki-saas'@'localhost';</kbd>
			## If you migrate an existing wiki from its db: <kbd>mysql yourwiki < dump.sql</kbd> + <kbd>mw update yourwiki</kbd> works well
			## If it's a fresh new wiki: <kbd>mw addWiki yourwiki</kbd> will create the database and populate the tables

	== How to deploy an extension or a skin? ==		== How to deploy an extension or a skin? ==

Dereckson: Created page with "We maintain an up-to-date MediaWiki installation to serve this wiki, and several others. If you license your content under an open source license like CC-BY, you're welcome t..."

2018-03-21T19:24:15Z

Created page with "We maintain an up-to-date MediaWiki installation to serve this wiki, and several others. If you license your content under an open source license like CC-BY, you're welcome t..."

New page

We maintain an up-to-date MediaWiki installation to serve this wiki, and several others.

If you license your content under an open source license like CC-BY, you're welcome to request hosting.

== Hosted wikis ==

The following wikis are hosted on this service:

* https://agora.nasqueron.org/ — this wiki
* https://www.wolfplex.org/wiki/ — Wolfplex Hackerspace wiki

== Repositories ==

* [https://devcentral.nasqueron.org/source/saas-mediawiki saas-mediawiki]: MediaWiki SaaS entry point: contains the wiki configuration and the MediaWiki bootstrap logic
* [https://devcentral.nasqueron.org/source/saas-service saas-service]: base entry point for SaaS: serves /status requests and contains some base classes
* [https://devcentral.nasqueron.org/source/operations rOPS]: describes the saas-mediawiki role provisioning instructions

== How to add a wiki? ==

# DNS: <your domain> CNAME saas-mediawiki.nasqueron.org
# Send a change to the Operations repository
## nginx: add your server block to the webserver-legacy role, you need to use <code>include includes/mediawiki-root</code> to serve /Article pages, or <code>include includes/mediawiki-wiki</code> to serve /wiki/Article pages (useful if you've other services than a wiki on this domain)
## data directory: add your canonical host to the pillar/saas/mediawiki.sls file in the mediawiki_datastores section

== How to deploy an extension or a skin? ==

* Ensure it's available on the service
** If it's hosted on gerrit.wikimedia.org, add it to pillar/saas/mediawiki.sls file in the rOPS repository
** If not, you need to provide custom logic at roles/saas-mediawiki/mediawiki
* Configure it
** Edit the saas-mediawiki config/Settings.php folder, saasUseExtensionFoo will load the Foo extension and saasUseSkinBar will load the bar skin.
** If you need more advanced logic, config/CommonsSettings.php contain a good example for Scribunto

== How to run a script against a wiki? ==

The <code>mw</code> command allow to run a maintenance script to a specific wiki.

For example <kbd>sudo -u mediawiki mw agora update</kbd> will run update.php for this wiki.