MediaWiki SaaS: Difference between revisions
From Nasqueron Agora
(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...") |
|||
| 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? == | ||
Revision as of 01:53, 1 April 2018
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
- saas-mediawiki: MediaWiki SaaS entry point: contains the wiki configuration and the MediaWiki bootstrap logic
- saas-service: base entry point for SaaS: serves /status requests and contains some base classes
- 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
include includes/mediawiki-rootto serve /Article pages, orinclude includes/mediawiki-wikito 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
- nginx: add your server block to the webserver-legacy role, you need to use
- Declare the dbname/host name pair for the new instance in the configuration
- Create a database
- In every case, GRANT ALL PRIVILEGES on wikis.* TO 'mediawiki-saas'@'localhost';
- If you migrate an existing wiki from its db: mysql yourwiki < dump.sql + mw update yourwiki works well
- If it's a fresh new wiki: mw addWiki yourwiki will create the database and populate the tables
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 mw command allow to run a maintenance script to a specific wiki.
For example sudo -u mediawiki mw agora update will run update.php for this wiki.
