Migration tips: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| (19 intermediate revisions by the same user not shown) | |||
| 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 == | |||
* Backup | |||
** LocalSettings.php | |||
** images | |||
** database | |||
<syntaxhighlight lang="bash"> | |||
docker compose exec mediawiki php maintenance/run.php update | |||
</syntaxhighlight> | |||
Latest revision as of 11:55, 4 October 2026
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
| 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 |
package versions
docker pull mediawiki:1.43.9
docker run -it mediawiki:1.43.9 bash
cat /etc/os-release
php -v
php -m
curl -V
debug
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"'
from 1.39 to 1.47
- Backup
- LocalSettings.php
- images
- database
docker compose exec mediawiki php maintenance/run.php update