Document running multiple MediaGoblin instances on one server.

docs/source/siteadmin/production-deployments.rst

@@ -107,7 +107,24 @@ documentation.
 .. _`raven`: http://raven.readthedocs.org
 
 
-.. TODO insert init script here
-.. TODO are additional concerns ?
-   .. Other Concerns
-   .. --------------
+Running multiple MediaGoblin instances on the same server
+---------------------------------------------------------
+
+It is possible to run multiple separate MediaGoblin instances concurrently on
+the same server. We don't provide detailed instructions to do this, but broadly,
+each instance will need:
+
+1. A separate ``mediagoblin.ini`` and ``paste.ini``.
+2. A separate database that is configured in ``mediagoblin.ini``.
+3. A unique ``CELERY_DEFAULT_QUEUE`` configured in ``mediagoblin.ini``. Queues
+   are automatically created, but must be unique between MediaGoblin instances.
+4. A separate data directory created and configured in ``mediagoblin.ini`` and
+   ``paste.ini``.
+5. A unique server port configured in ``paste.ini`` under ``[server:broadcast]``.
+
+You would typically configure the web server to route requests to the
+appropriate MediaGoblin instance port based on the requested domain name or
+something similar.
+
+It is also possible to share the same MediaGoblin codebase and Python virtualenv
+between multiple instances, so long as they have a unique data directory.

docs/source/siteadmin/relnotes.rst

@@ -39,6 +39,7 @@ This chapter has important information about our current and previous releases.
 - Remove references to previous `tinymce` JS dependency (Ben Sturmfels)
 - Remove plugin for decommissioned Mozilla Persona (Jgart)
 - Remove Debian 10 development Dockerfile (BenSturmfels)
+- Document running multiple MediaGoblin instances on one server (Ben Sturmfels)
 
 **Bug fixes:**
 

mediagoblin.example.ini

@@ -9,7 +9,7 @@
 # directory in paste.ini and/or your webserver configuration.
 #
 # [DEFAULT]
-# data_basedir = "/var/lib/mediagoblin"
+# data_basedir = %(here)s/user_dev
 
 [mediagoblin]
 direct_remote_path = /mgoblin_static/
@@ -61,7 +61,7 @@ base_dir = %(data_basedir)s/media/public
 base_url = /mgoblin_media/
 
 [celery]
-# Put celery stuff here
+# CELERY_DEFAULT_QUEUE = "default"
 
 # Place plugins here, each in their own subsection of [plugins].
 # See http://docs.mediagoblin.org/siteadmin/plugins.html for details.