Tworzenie i publikowanie własnych obrazów Docker dla aplikacji PHP

5 min. czytaniaZaktualizowano

Jak buduję własny obraz PHP (dommin/php-8.4-fpm), publikuję go na Docker Hub i przebudowuję z GitHub Actions.

Dlaczego warto tworzyć własne obrazy Docker?

Trzymam własny obraz PHP z trzech powodów: każdy deweloper i każdy job CI dostaje te same wersje PHP i rozszerzeń, buildy nie instalują za każdym razem popularnych pakietów, a PHP ma wersję niezależną od kodu aplikacji.

To obraz dommin/php-8.4-fpm z poprzednich artykułów, z PHP 8.4, popularnymi rozszerzeniami, Node.js i Composerem.

Planowanie własnego obrazu PHP

Kluczowe aspekty do rozważenia:

Zacznij od opartego na Debianie php:8.4-fpm. Zdecyduj, jakich rozszerzeń PHP i pakietów systemowych potrzebują aplikacje, jakie narzędzia mają wejść do obrazu (Composer, Node.js, Git) i jak dopasować uprawnienia plików między hostem a kontenerem (USER_ID/GROUP_ID).

Przykład wymagań:

Dla Laravela potrzebuję:

  • PHP 8.4 z FPM
  • Rozszerzenia: PDO, MySQL, PostgreSQL, GD, Zip, BCMath, Redis, itp.
  • Composer
  • Node.js i NPM
  • Git dla zależności Composera

Budowanie własnego obrazu PHP

Dockerfile:

dockerfile
FROM php:8.4-fpm

ARG USER_ID=1000
ARG GROUP_ID=1000

RUN apt-get update && apt-get install -y --no-install-recommends \
    git curl unzip zip \
    libpng-dev libjpeg-dev libwebp-dev libfreetype6-dev \
    libonig-dev libxml2-dev libzip-dev \
    imagemagick libmagick++-dev \
    libpq-dev \
    autoconf g++ make \
    supervisor \
    rsync  \
    wget gnupg2 \
    && mkdir -p /etc/apt/keyrings \
    && curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
    && echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" > /etc/apt/sources.list.d/nodesource.list \
    && apt-get update \
    && apt-get install -y nodejs \
    && pecl install redis imagick xdebug \
    && docker-php-ext-enable redis imagick xdebug \
    && docker-php-ext-configure gd --with-freetype --with-jpeg --with-webp \
    && docker-php-ext-install -j$(nproc) \
        pdo_mysql pdo_pgsql mysqli \
        zip bcmath pcntl intl \
        gd opcache \
    && wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor -o /etc/apt/keyrings/google-chrome.gpg \
    && echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/google-chrome.gpg] https://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list \
    && apt-get update \
    && apt-get install -y google-chrome-stable \
    && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

RUN groupmod -g ${GROUP_ID} www-data \
    && usermod -u ${USER_ID} -g www-data www-data \
    && mkdir -p /var/www /var/log/supervisor /var/run/supervisor \
    && chown -R www-data:www-data /var/www /var/log/supervisor /var/run/supervisor

COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

WORKDIR /var/www

EXPOSE 9000

CMD ["php-fpm"]

Wyjaśnienie kluczowych komponentów:

Node.js 22.x pochodzi z NodeSource, Composer jest kopiowany z oficjalnego obrazu composer, a USER_ID/GROUP_ID przemapowują www-data na użytkownika hosta. Poza zwykłymi rozszerzeniami obraz instaluje też Xdebug, Imagick, supervisor i Google Chrome. Xdebug jest włączony domyślnie, co spowalnia każde żądanie PHP, więc używaj tego obrazu do developmentu i CI; na produkcję zbuduj odchudzony obraz bez Xdebuga i Chrome. Repozytorium Chrome jest dodane przez podpisany keyring (apt-key jest przestarzałe), a NodeSource tak samo, zamiast przekazywania skryptu do bash.

Publikowanie na Docker Hub

Obraz trafia na Docker Hub.

1. Utwórz konto na Docker Hub

Jeśli jeszcze go nie masz, zarejestruj się na Docker Hub.

2. Utwórz repozytorium

Kliknij "Create Repository" w panelu, nadaj nazwę (np. username/php) i ustaw widoczność: publiczne lub prywatne.

3. Zaloguj się do Docker Hub z CLI

bash
docker login

Wprowadź nazwę użytkownika i osobisty token dostępu Docker Hub (Account settings, Security) po wyświetleniu monitu.

4. Zbuduj swój obraz

bash
docker build -t username/php:8.4-fpm -f ./Dockerfile .

5. Wypchnij swój obraz na Docker Hub

bash
docker push username/php:8.4-fpm

6. Zweryfikuj przesłanie

Odwiedź swoje repozytorium na Docker Hub i sprawdź, czy obraz się przesłał.

Automatyzacja budowania z GitHub Actions

Workflow GitHub Actions przebudowuje i wypycha obraz przy każdym pushu na main. Potrzebuje sekretów repozytorium DOCKER_USERNAME i DOCKER_PASSWORD (użyj tokenu dostępu Docker Hub, nie hasła do konta). Każdy build dostaje też tag z SHA commita, więc projekt możesz przypiąć do konkretnego obrazu zamiast latest:

yaml
name: Build images

on:
  push:
    branches:
      - main

env:
  PHP_IMAGE: dommin/php-8.4-fpm:latest

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}
      - name: Build images
        run: docker build -t $PHP_IMAGE -t dommin/php-8.4-fpm:${{ github.sha }} -f ./8.4-fpm/Dockerfile .
      - name: Push images
        run: docker push --all-tags dommin/php-8.4-fpm

Podsumowanie

Obraz jest budowany z powyższego Dockerfile, publikowany jako dommin/php-8.4-fpm:latest i przebudowywany przez workflow przy każdym pushu na main.

Kod źródłowy

Powiązane artykuły

Wsparcie istniejącego systemu

Potrzebujesz pomocy z działającą aplikacją?

Pomagam firmom rozwijać działające systemy, porządkować wdrożenia i dodawać nowe funkcje bez dokładania chaosu do projektu.

Komentarze (0)
Zaloguj się, aby dodać komentarz

Musisz być zalogowany, aby dodać komentarz.

Zaloguj się

Potrzebujesz kogoś, kto weźmie odpowiedzialność za kolejny krok?

Porozmawiajmy o Twoim projekcie i określmy zakres, który ma sens dla Twoich celów.