Editing Wiki.tetrain.com Runbook (section)

=== 3.3 Per-hop Dockerfile (shared template, confirmed exact via <code><nowiki>docker history --no-trunc</nowiki></code>) ===

One template, parameterized by PHP tag:

<pre>
<nowiki>
# Dockerfile.template
ARG PHP_TAG
FROM php:${PHP_TAG}
RUN apt-get update && apt-get install -y --no-install-recommends \
    libicu-dev libpng-dev libjpeg-dev libxml2-dev libonig-dev zlib1g-dev \
    && docker-php-ext-configure gd --with-jpeg 2>/dev/null || docker-php-ext-configure gd 2>/dev/null || true \
    && docker-php-ext-install mysqli intl gd mbstring calendar opcache 2>&1 | tail -20 \
    && rm -rf /var/lib/apt/lists/*
</nowiki>
</pre>

(This is the literal, byte-for-byte content still on disk at <code><nowiki>/root/mw-hop-migration/hops/Dockerfile.template</nowiki></code>; the <code><nowiki>RUN</nowiki></code> line matches exactly what <code><nowiki>docker history --no-trunc mw-hop1-1.23:latest</nowiki></code> shows as that image's top custom layer.)

PHP tag per hop (confirmed by running <code><nowiki>php -v</nowiki></code> inside each surviving image):

{| class="wikitable"
|-
! Hop !! MediaWiki !! PHP tag !! Confirmed running <code><nowiki>php -v</nowiki></code>
|-
| 1 || 1.23.16 || <code><nowiki>php:5.6-apache</nowiki></code> || PHP 5.6.40
|-
| 2 || 1.27.7 || <code><nowiki>php:5.6-apache</nowiki></code> || PHP 5.6.40
|-
| 3 || 1.31.16 || <code><nowiki>php:7.2-apache</nowiki></code> || PHP 7.2.34
|-
| 4 || 1.35.13 || <code><nowiki>php:7.4-apache</nowiki></code> || PHP 7.4.33
|-
| 5 || 1.39.11 || <code><nowiki>php:8.0-apache</nowiki></code> || PHP 8.0.30
|-
| 6 || 1.43.9 || <code><nowiki>php:8.1-apache</nowiki></code> || PHP 8.1.34
|}

Build each image (repeat per row above):

<pre>
<nowiki>
cd /root/mw-hop-migration/hops
mkdir -p hop1-1.23 && cd hop1-1.23
tar xzf ../../tarballs/mediawiki-1.23.16.tar.gz --strip-components=1 -C . --one-top-level=src 2>/dev/null \
  || (mkdir -p src && tar xzf ../../tarballs/mediawiki-1.23.16.tar.gz --strip-components=1 -C src)
cp ../Dockerfile.template Dockerfile
docker build --build-arg PHP_TAG=5.6-apache -t mw-hop1-1.23:latest .
cd ..
</nowiki>
</pre>

Repeat for hop2 (<code><nowiki>5.6-apache</nowiki></code>), hop3 (<code><nowiki>7.2-apache</nowiki></code>), hop4 (<code><nowiki>7.4-apache</nowiki></code>), hop5 (<code><nowiki>8.0-apache</nowiki></code>), hop6 (<code><nowiki>8.1-apache</nowiki></code>), substituting the tarball, directory name, and <code><nowiki>PHP_TAG</nowiki></code> each time.

'''Verify''': <code><nowiki>docker images</nowiki></code> should list all 6 (still true on the live box today, ~700-850MB each).