Migration tips: Difference between revisions

Latest revision as of 11:55, 4 October 2026

Image	Included Web Server	PHP Execution Method	Base OS	Recommended Use Case
`mediawiki:1.43`	Apache	mod_php	Debian	Simple deployment with a single container
`mediawiki:1.43-fpm`	None	PHP-FPM	Debian	Use with Nginx or an existing Apache server
`mediawiki:1.43-fpm-alpine`	None	PHP-FPM	Alpine Linux	Smaller image size for users familiar with Alpine

docker pull mediawiki:1.43.9
docker run -it mediawiki:1.43.9 bash

cat /etc/os-release
php -v
php -m
curl -V

Permission problem usually arize when upgrade new version. At that time, bash into the container is necessary for debugging.

sudo docker exec -it mw-main bash
sudo docker exec -it mw-main mmdc -V
sudo docker exec -it mw-main bash -c 'echo $PATH | tr ":" "\n"'

docker compose exec mediawiki php maintenance/run.php update

@@ Line 1: / Line 1: @@
+== Steps ==
+* Choose new image
+* Update docker-compose.yaml
+* Check docker-compose.yaml by docker compose config
+* docker compose up
+* List package versions
+* Test extensions
+* Check file system permissions
+== Choose new image ==
+=== Comparison ===
+{| class="wikitable"
+! Image
+! Included Web Server
+! PHP Execution Method
+! Base OS
+! Recommended Use Case
+|-
+| <code>mediawiki:1.43</code>
+| Apache
+| mod_php
+| Debian
+| Simple deployment with a single container
+|-
+| <code>mediawiki:1.43-fpm</code>
+| None
+| PHP-FPM
+| Debian
+| Use with Nginx or an existing Apache server
+|-
+| <code>mediawiki:1.43-fpm-alpine</code>
+| None
+| PHP-FPM
+| Alpine Linux
+| Smaller image size for users familiar with Alpine
+|}
+=== package versions ===
+<syntaxhighlight lang="bash">
+docker pull mediawiki:1.43.9
+docker run -it mediawiki:1.43.9 bash
+cat /etc/os-release
+php -v
+php -m
+curl -V
+</syntaxhighlight>
+=== debug ===
+Permission problem usually arize when upgrade new version.
+At that time, bash into the container is necessary for debugging.
+<syntaxhighlight lang="bash">
+sudo docker exec -it mw-main bash
+sudo docker exec -it mw-main mmdc -V
+sudo docker exec -it mw-main bash -c 'echo $PATH | tr ":" "\n"'
+</syntaxhighlight>
 == from 1.39 to 1.47 ==
@@ Line 6: / Line 69: @@
 ** database
-<source lang="bash">
+<syntaxhighlight lang="bash">
 docker compose exec mediawiki php maintenance/run.php update
-</source>
+</syntaxhighlight>