Add test webshare docs

web/index.markdown

@@ -35,6 +35,7 @@ Our web servers at the D-PHYS use [Apache](https://httpd.apache.org/) + [MariaDB
 - Personal homepage [people.phys.ethz.ch](https://people.phys.ethz.ch/) for all D-PHYS [[users|account]]
 - Groupshare homepage [share.phys.ethz.ch](https://share.phys.ethz.ch/) for all D-PHYS [[groups|account/groups]]
 - [[Dedicated websites (web shares)|web/webshares]] for more demanding applications and a `foo.phys.ethz.ch` or `bar.ethz.ch` URL
+- [[Test and staging environments (test web shares)|web/test_webshares]] for web share development
 - [[calendar/Groupware]]
 
 ## Support and announcement room

web/test_webshares.markdown

+# Test webshares
+
+Sometimes it can be useful to have a clone of your [[website|/web/webshares]] or database
+in order to test version upgrades or as a staging environment for development.
+
+## Server setup and conditions
+
+The web and database server are hosted separately from the production servers,
+which is also used by us (ISG) as testing environment and for regular OS upgrade tests of the production servers.
+This will enhance synergies between us and users willing to invest in testing
+to get their websites up and running more quickly after OS upgrades.
+
+Conditions:
+
+- There is **no backup**. Use git + gitlab to track/store your changes
+- The servers can be destroyed/re-deployed at any time without notice
+- All untracked changes/data will be lost
+- Join Matrix room [#web:phys.ethz.ch](https://m.ethz.ch/#/#web:phys.ethz.ch) and be online
+- Announcements only via Matrix room on very short notice
+
+## Requesting a new test webshare
+
+Test webshares use the identical setup as documented in [[website|/web/webshares]].
+
+We will create a complete initial clone of your existing production site, with the following changes:
+
+- test web share name: identical to your production `www<name>`
+- domain name: `test-<your_production_domain>`
+- database server: see `private/database.yml` on test webshare
+- no NFS/SMB access possible (no web share members)
+
+Please provide:
+
+- SSH access: D-PHYS username(s) + [[ssh keys|/documentation/ssh_keys/]]
+- anything else that should be different?
+
+## SSH Access
+
+The [[webshare data|/web/webshares/#access-the-files-and-directory-structure]]
+of the test wenshare is accessible by SSH only.
+See [[ssh access|/web/webshares/#ssh-access]] but connect using:
+
+```sh
+ssh www<name>@test-<your_production_domain>
+```
+
+## Access the database
+
+Use the same [[webinterface|/web/webshares/#access-the-database]] but select the server `test-sqlweb`
+and connect using the credentials in `private/database.yml` on the test webshare.
+
+We recommend directly including the credentials from the file mentioned above in your code,
+which will allow to share identical website configuration between production and testing.
+
+The database hostname is `test-sqlweb.phys.ethz.ch`.

web/webshares.markdown

@@ -17,7 +17,7 @@ Optional website specifics:
 - CMS installation: Wordpress, Drupal, TWiki, Mediawiki, etc?
 - SQL database (MariaDB): Yes/No?
 - dynamic content: provide CGI file extensions (`.php`, `.pl`, `.py`, `.cgi`, etc)
-- Python 3 WSGI web app: provide required modules
+- Python 3 WSGI web app: provide modules in `private/requirements.txt`
 - SSH access (power users): D-PHYS username(s) + [[ssh keys|/documentation/ssh_keys/]]
 
 To check if your desired domain name is still available, you can use any managed Linux workstation:
@@ -132,3 +132,7 @@ It is implemented using `libapache2-mod-fcgid` and `mod_suexec` via an ISG manag
 ## Python 3 web applications
 
 See [[/web/wsgi]].
+
+## Test and staging environments
+
+See [[/web/test_webshares]].