Deploy và chạy ứng dụng trong docker container giờ cũng không còn là chuyện gì xa lạ nữa rồi. Hướng dẫn cũng có ở khắp mọi nơi. Nhưng khi nhúng tay vào làm mới biết mọi thứ không đơn giản chỉ là copy code và cài PHP. Nhất là cả những vấn đề mà bạn không thể nhận ra nếu bạn chỉ dừng ở bước build image mà chưa deploy và chạy nó trên production. Bài này mình sẽ tổng hợp những thứ mình biết sau những gì mình đã trải qua để giúp mọi người build được một image cho Laravel app của mình sao cho phù hợp nhất nhé.

Base image

Chọn base image tưởng có vẻ không quan trọng lắm nhưng nó sẽ ảnh hưởng đến image cuối cùng của bạn. Bạn có 2 lựa chọn, một là dùng một distro image (ubuntu, debian, alpine) rồi cài PHP và các package, extension cần thiết. Hoặc là dùng image cài sẵn PHP (official image php).

Thường thì sử dụng distro image và cài PHP sẽ cho image size nhỏ hơn. Nếu bạn dùng debian thì image sẽ nhỏ hơn image php official khoảng 300MB, còn với alpine là khoảng 60MB. Image build cũng sẽ nhanh hơn vì các extension đã được build sẵn và bạn chỉ cần tải về qua package manager (apt-get, apk) thay vì build từ source. Tuy nhiên version update có thể sẽ chậm hơn một chút vì nó phụ thuộc vào maintainer của package bạn dùng.

Nếu bạn chọn official image thì image size sẽ to hơn một chút. Bù lại thì nó đã được config sẵn để phù hợp với môi trường trong container. Chọn version cho cũng rất đơn giản, chỉ cần chọn tag bạn muốn là xong. Version mới cũng được update sớm và đầy đủ hơn. Thậm chí phiên bản mới nhất vẫn còn đang RC cũng đã có luôn rồi.

Có 2 lựa chọn distro phổ biến là debian và alpine. Debian thì có thể sẽ quen thuộc với bạn hơn vì nó khá phổ biến trên server và PC. Alpine thì lại có kích thước image nhỏ hơn rất nhiều. Busybox cũng có sắn nhiều tool quen thuộc như vi, wget, ps, top, netstat... nên bạn không cần cài thêm nữa. Gần như khác biệt duy nhất mà bạn có thể nhận thấy chỉ là về package manager. Alpine dùng apk thay vì apt-get và tên các package cũng khác nữa. Tuy nhiên nếu muốn dùng alpine thì có vài lưu ý bạn cần quan tâm.

Đầu tiên alpine dùng thư viện C khác nên binary được build cho debian sẽ không chạy được trên alpine. Mà nếu được build trên alpine cũng chưa chắc nó sẽ chạy được giống như trên debian. Một package quen thuộc mà bạn sẽ gặp vấn đề này là barryvdh/laravel-snappy.

Tiếp theo, alpine có thể sẽ xóa các phiên bản cũ của các package. Vậy nên nếu bạn cần package nào đó với version chính xác thì có thể là bạn không nên dùng alpine. Tuy nhiên những package được nhiều người sử dụng như python, npm... thì thường sẽ không bị xóa nên cũng không cần quá lo lắng.

Tóm lại là:

• Nếu bạn không biết nên dùng cái nào thì hãy dùng official image với debian (php:7.4-fpm-buster, php:8.0-fpm-buster).
• Nếu image không có gì đặc biệt thì hãy cân nhắc sử dụng alpine để có image size nhỏ hơn (php:7.4-fpm-alpine, php:8.0-fpm-alpine).
• Nếu bạn muốn image nhỏ hơn nữa và build nhanh hơn thì hãy dùng base image là một distro (ubuntu, debian, alpine). và tự cài PHP cùng với các extension và package bạn muốn.

Build steps

Chọn xong base image rồi thì mình bắt đầu build thôi. Mình sẽ dùng base image là php:8.0-fpm-alpine nhé.

FROM php:8.0-fpm-alpine

Nhìn chung thì đưa một app vào trong container sẽ gồm những bước sau:

• Cài package/dependecies
• Copy code
• Set entrypoint

Cài extension

Đầu tiên là cài những extension cần thiết. Với zip thì thường bạn sẽ cần thêm các extension sau:

• bcmath
• pdo_mysql
• opcache
• zip

Ngoài ra nếu bạn dùng PostgreSQL thì sẽ cần thêm pdo_pgsql thay vì pdo_mysql. Và bạn có thể thêm redis để dùng phpredis với hiệu năng gấp 6-7 lần so với predis.

Bước này thì Dockerfile của mình sẽ trông như thế này.

FROM php:8.0-fpm-alpine

ENV RUN_DEPS \
    zlib \
    libzip \
    postgresql-libs

ENV BUILD_DEPS \
    zlib-dev \
    libzip-dev \
    postgresql-dev

ENV PHP_EXTENSIONS \
    opcache \
    zip \
    bcmath \
    pdo_mysql \
    pdo_pgsql

ENV PECL_EXTENSIONS \
    redis

RUN apk add --no-cache --virtual .build-deps $BUILD_DEPS \
    && pecl install $PECL_EXTENSIONS \
    && docker-php-ext-install -j "$(nproc)" $PHP_EXTENSIONS \
    && docker-php-ext-enable $PECL_EXTENSIONS \
    && apk del .build-deps

RUN apk add --no-cache --virtual .run-deps $RUN_DEPS

Ở đoạn trên mình đã đặt các package/extension cần cài thành biến môi trường để command trong RUN dễ nhìn hơn. Một số extension phụ thuộc vào các package khác nên chúng ta có RUN_DEPS là các package cần cài thêm. Với image official mình sẽ phải dùng tiện ích có sẵn của image là docker-php-ext-install để cài extension. Khác với cách cài dùng package manager thì nó sẽ tải source code của extension để compile nên chúng ta sẽ có BUILD_DEPS là các package cần cài thêm để build extension.

Bước này chạy khá lâu nên tốt nhất bạn nên tách đoạn này thành một image riêng và dùng nó làm base image để tiết kiệm thời gian build cho những lần sau.

Nginx

Với PHP-FPM, bạn sẽ cần một web server để xử lý request nữa. 2 lựa chọn phổ biến nhất là Apache và NGINX. Mình sẽ dùng NGINX nhé. Chúng ta sẽ phải chạy NGINX trong cùng một container với PHP-FPM để có thể truy cập các file static (folder public của Laravel). Có nhiều cách để chạy nhiều process trong cùng một container. Mình sẽ dùng s6-overlay, vốn được viết đặc biệt để chạy trong container.

Process của s6-overlay sẽ là process chính của container (entrypoint). Chúng ta sẽ cần 2 file để define 2 process sẽ chạy (PHP-FPM và NGINX) trong folder /etc/services.d như sau.

#!/usr/bin/with-contenv sh

exec docker-php-entrypoint php-fpm

#!/usr/bin/execlineb -P

nginx -g "daemon off;"

Ngoài ra thì image PHP mặc định sẽ listen ở port 9000 thay vì unix socket giống như bạn cài từ package manager. Vậy nên cần thêm config cho PHP-FPM như sau.

[global]
daemonize = no

[www]
listen = /run/php/php-fpm.sock
listen.owner = www-data
listen.group = www-data

Cuối cùng là config cho NGINX.

server {
    listen 80;

    root  /var/www/html/public;
    index index.html index.htm index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php {
        fastcgi_pass    unix:/run/php/php-fpm.sock;
        fastcgi_param   SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include         fastcgi_params;
        internal;
    }
}

Dockerfile để cài s6-overlay và nginx của mình sẽ như này.

# Cài s6-overlay
ENV S6_OVERLAY_RELEASE=https://github.com/just-containers/s6-overlay/releases/latest/download/s6-overlay-amd64.tar.gz
RUN curl -sL ${S6_OVERLAY_RELEASE} | tar xzf - -C /

# Cài NGINX
RUN apk add --no-cache nginx

# Tạo folder cho socket của nginx.pid và php-fpm.sock
RUN mkdir -p /run/nginx /run/php

# Copy chỗ file config lúc nãy
COPY services /etc/services.d
COPY php-fpm.d /usr/local/etc/php-fpm.d
COPY nginx /etc/nginx/conf.d

Composer install

Bước tiếp theo là cài composer và các package cho app của bạn.

RUN wget -qO /usr/local/bin/composer https://getcomposer.org/download/2.1.3/composer.phar \
    && chmod +x /usr/local/bin/composer

COPY composer.json composer.lock .

RUN composer install \
    --no-interaction \
    --ansi \
    --no-progress \
    --no-dev \
    --ignore-platform-reqs \
    --no-autoloader \
    --no-scripts

Mình thêm --no-autoloader và --no-script vì chỗ này mình vẫn chưa copy code vào nên chưa có gì để dump autoload.

Code và Entrypoint

Bước cuối cùng chỉ còn là copy code của bạn vào image và set entrypoint. Với Laravel thì chúng ta có thể có tới 3 process cần chạy.

• PHP-FPM cho web app
• Queue worker (php artisan queue:work)
• Cronjob (php artisan schedule:run)

Entrypoint của mình sẽ trông như này.

#!/bin/sh

if [ "$1" = "web" ] || [ "$1" = "worker" ] || [ "$1" = "cron" ]; then
    # Cache config, view, route và migrate
    php artisan optimize
    php artisan migrate --force
fi

if [ "$1" = "web" ]; then
    # Đây là entrypoint của s6-overlay
    /init
elif [ "$2" = "worker" ]; then
    exec docker-php-entrypoint su www-data s /bin/sh -c 'php artisan queue:work'
elif [ "$2" = "cron" ]; then
    echo "* * * * * php /var/www/html/artisan schedule:run" | crontab -u www-data -
    exec docker-php-entrypoint crond -fl 2
else
    exec "[email protected]"
fi

Như vậy thì với cùng một image, tùy vào command mà container của chúng ta sẽ chạy web app, worker hoặc là cronjob. Toàn bộ Dockerfile của mình sẽ trông như này. Phần cài extension như đã nói từ trước bạn nên tách ra thành một image riêng và dùng nó làm base image nhé.

FROM <image PHP mà bạn vừa build ở trên>

RUN apk add --no-cache nginx

ENV S6_OVERLAY_RELEASE=https://github.com/just-containers/s6-overlay/releases/latest/download/s6-overlay-amd64.tar.gz

RUN curl -sL ${S6_OVERLAY_RELEASE} | tar xzf - -C /

RUN mkdir -p /run/nginx /run/php

COPY services /etc/services.d
COPY php-fpm.d /usr/local/etc/php-fpm.d

WORKDIR /var/www/html

RUN wget -qO /usr/local/bin/composer https://getcomposer.org/download/2.1.3/composer.phar \
    && chmod +x /usr/local/bin/composer

COPY composer.json composer.lock .

RUN composer install \
    --no-interaction \
    --ansi \
    --no-progress \
    --no-dev \
    --ignore-platform-reqs \
    --no-autoloader \
    --no-scripts

COPY entrypoint.sh /usr/local/bin

# Copy code của bạn vào image
COPY . .

# Dump autoload sau khi bạn đã copy code
RUN composer dump-autoload

EXPOSE 80

ENTRYPOINT entrypoint.sh

CMD web

Config

Với image như trên là đủ để bạn chạy app rồi. Tuy nhiên, app chạy trong môi trường container cần thêm một vài config nhỏ nữa để chạy hiệu quả hơn.

PHP-FPM và NGINX

Đầu tiên là với PHP-FPM. Vì chúng ta chạy cả NGINX trong cùng container nên sẽ có 2 cái access log, của PHP-FPM và NGINX. Vậy nên hãy tắt một cái đi, ở đây thì access log của NGINX có nhiều thông tin hơn nên hãy tắt của PHP-FPM đi nhé.

access.log = /dev/null

Mà thường thì bạn sẽ có một cái load balancer khác (có thể cũng là NGINX) đứng trước container web app của bạn nên có thể tắt luôn log của NGINX đi cũng được.

access_log off;
error_log  off;

Laravel

Giờ đến log của Laravel. Mặc định thì nó sẽ ghi log ra file .log trong folder storage/logs. Nhưng vấn đề là mỗi lần container reset thì những file đã được ghi ra đều sẽ bị mất. Bạn có thể mount folder log từ một volume. Nhưng nếu bạn có nhiều server thì file log của bạn sẽ ở mỗi nơi một ít. Giải pháp quen thuộc của docker là dùng một hệ thống log tập trung như ELK (Elasticsearch + Logstash + Kibana) hoặc GPL (Grafana + Promtail + Loki).

Phần lớn các giải pháp log tập trung có thể đọc từ file log, nhưng đơn giản nhất là đọc từ output (stdout, stderr) của container. Vậy nên best practice của mọi docker container là log ra stdout/stderr chứ không phải là file log như mặc định như chúng ta có. Laravel có sẵn một log driver stderr để support trường hợp này. Vậy nên hãy set biến môi trường:

LOG_STACK=stderr

Cũng với lí do tương tự như trên, chúng ta cũng sẽ không thể dùng session driver mặc định là file mà phải dùng những driver có thể được chia sẻ với nhiều server như Redis

SESSION_DRIVER=redis

Maintenance mode

Có vẻ ít ai quan tâm đến cái này nhưng mà cũng tương tự như trên, maintenance mode (php artisan down) sẽ ghi một file vào storage để check xem app có đang được maintain hay không. Vậy nên tính năng này mặc định cũng không thể sử dụng được trừ khi bạn chỉ chạy một container duy nhất.