From 1c05fd39a445e1a0dd121b969779e7d1ceb5ea39 Mon Sep 17 00:00:00 2001
From: teutat3s <teutates@mailbox.org>
Date: Mon, 8 Jan 2024 14:54:25 +0100
Subject: [PATCH] docs: how to update mediawiki wiki.pub.solar

---
 docs/mediawiki-updates.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 docs/mediawiki-updates.md

diff --git a/docs/mediawiki-updates.md b/docs/mediawiki-updates.md
new file mode 100644
index 00000000..4f49b6b6
--- /dev/null
+++ b/docs/mediawiki-updates.md
@@ -0,0 +1,31 @@
+# Updating mediawiki docker container
+
+See the [mediawiki-oidc-docker repository](https://git.pub.solar/pub-solar/mediawiki-oidc-docker#updating-the-docker-image)
+for instructions on updating our customized mediawiki docker image.
+
+To deploy a new docker image to `nachtigall`, first bump the mediawiki version
+of the docker image tag in `hosts/nachtigall/apps/mediawiki.nix` (search for
+`image`).
+
+Next, push your changes to https://git.pub.solar and get them reviewed and
+approved.
+
+After approval, create a fresh backup of the database and deploy the changes to
+`nachtigall`:
+
+```
+ssh barkeeper@nachtigall.pub.solar
+sudo -u postgres pg_dump --create -Fc mediawiki > mediawiki-db-$(date +%F).dump
+exit
+```
+
+```
+deploy --targets '.#nachtigall'
+```
+
+Then, finalize the update by running the database migration script:
+```
+ssh barkeeper@nachtigall.pub.solar
+docker exec -it mediawiki bash
+php maintenance/run.php update.php
+```