DevOps cho PHP: Docker, CI/CD, deploy không downtime, observability
Đưa ứng dụng Laravel lên production và giữ nó sống: Docker image (FrankenPHP hoặc Nginx + PHP-FPM), CI/CD, các lựa chọn hosting (VPS + Forge, Laravel Cloud, Vapor, Kubernetes), deploy không downtime, migration và queue khi deploy, log, metric, trace, error tracking.
Fullstack PHP $5000 thường được kỳ vọng tự đưa tính năng lên production và xử lý sự cố — không ném sang ai khác. Ứng
viên có app chạy trên domain thật, pipeline tự động, giám sát và câu chuyện xử lý sự cố nổi bật hẳn so với người chỉ có repo
chạy php artisan serve.
🎯 Mục tiêu học tập
- Viết Dockerfile production cho Laravel; Docker Compose cho môi trường dev đầy đủ
- Xây CI/CD GitHub Actions: kiểm tra, build, deploy
- Chọn hình thức hosting phù hợp và deploy không downtime
- Xử lý migration, cache, queue worker, scheduler đúng cách khi deploy
- Cài log có cấu trúc, error tracking, metric, trace và cảnh báo
Docker cho Laravel
# Dockerfile — FrankenPHP (một container có cả web server và PHP)
FROM composer:2 AS vendor
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --no-dev --no-scripts --prefer-dist --no-interaction
FROM node:22-alpine AS assets
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM dunglas/frankenphp:1-php8.4 AS app
RUN install-php-extensions pdo_mysql redis intl zip opcache pcntl
WORKDIR /app
COPY . .
COPY --from=vendor /app/vendor ./vendor
COPY --from=assets /app/public/build ./public/build
RUN composer dump-autoload --optimize --classmap-authoritative \
&& chown -R www-data:www-data storage bootstrap/cache
USER www-data
CMD ["php", "artisan", "octane:frankenphp", "--host=0.0.0.0", "--port=8000"]
- Thay thế truyền thống: hai container Nginx + PHP-FPM (image chính thức
php:8.4-fpm). - Cùng image chạy các vai trò khác nhau: web,
queue:work/Horizon,schedule:work. - Dev: Laravel Sail hoặc Docker Compose với MySQL/PostgreSQL, Redis, Meilisearch, MinIO, Mailpit.
- Không đưa
.envvào image; cấu hình qua biến môi trường/secret manager.
CI/CD và các lựa chọn hosting
| Lựa chọn | Mô tả | Hợp với |
|---|---|---|
| VPS + Laravel Forge / Ploi | Tự cấp server, công cụ quản lý Nginx/PHP/queue/SSL và deploy | Phổ biến nhất ở agency, startup; chi phí thấp |
| Laravel Cloud | Nền tảng managed chính thức: autoscaling, DB, cache, queue | Không muốn quản lý server |
| Laravel Vapor | Serverless trên AWS Lambda | Tải biến động lớn, hệ sinh thái AWS |
| Container (ECS, Cloud Run, Kubernetes) | Image Docker, orchestrator | Công ty có hạ tầng container sẵn |
# Bước deploy điển hình
composer install --no-dev --optimize-autoloader
php artisan migrate --force # migration tương thích ngược (Module 6)
php artisan optimize # cache config, route, view, event
php artisan queue:restart # hoặc horizon:terminate — worker nạp code mới
# reload PHP-FPM (vì opcache.validate_timestamps=0) / octane:reload
Deploy không downtime
- Atomic release trên VPS (Envoyer, Deployer, Forge zero-downtime): mỗi lần deploy vào thư mục
releases/2026…, dùng chungstorage/và.env, chuẩn bị xong mới đổi symlinkcurrent→ rollback bằng đổi symlink về bản trước. - Container: rolling update với readiness check (
/uphealth route của Laravel), graceful shutdown cho worker. - Phiên bản cũ và mới chạy song song trong lúc chuyển → migration và payload job phải tương thích cả hai phía.
- Chế độ bảo trì (
php artisan down --secret=...) chỉ cho thay đổi bắt buộc dừng.
Observability
| Công cụ | Dùng cho |
|---|---|
| Laravel Telescope | Debug ở local/staging: request, query, job, mail — không bật public trên production |
| Laravel Pulse | Dashboard production nhẹ: request chậm, query chậm, job, exception, người dùng tốn tài nguyên |
| Laravel Nightwatch / Sentry / Flare / Bugsnag | Error tracking và giám sát hiệu năng, gắn release |
| OpenTelemetry, Datadog, New Relic | Trace phân tán, APM khi có nhiều service |
| Log JSON (Monolog) → Loki / CloudWatch / ELK | Log có cấu trúc kèm request_id, user_id, tenant_id |
- Giám sát riêng cho PHP: FPM (active/idle/listen queue), OPcache hit rate, độ dài hàng đợi Horizon, scheduler có chạy không (heartbeat).
- Alert theo triệu chứng người dùng thấy (tỷ lệ 5xx, p95 latency, job thất bại) thay vì CPU.
- Health check
/upvà sự kiệnDiagnosingHealthkiểm tra DB/Redis.
🏋️ Bài tập thực hành
(1) Dockerfile production (FrankenPHP/Octane hoặc Nginx + FPM) và Compose cho dev. (2) GitHub Actions: Pint, PHPStan, Pest với DB + Redis service, build asset; deploy tự động khi merge main. (3) Deploy lên VPS bằng Forge/Deployer (atomic release) hoặc Laravel Cloud, có HTTPS, domain thật. (4) Horizon và scheduler chạy dưới supervisor/container riêng, restart khi deploy. (5) Sentry/Nightwatch + Pulse + log JSON; alert khi tỷ lệ 5xx tăng và khi hàng đợi dài. (6) Tự gây sự cố (Redis dừng), tìm nguyên nhân bằng công cụ giám sát, viết postmortem 1 trang.
📚 Tài nguyên học tập
-
Laravel — DeploymentCấu hình server và tối ưu khi deployDocs
-
FrankenPHP — DockerImage Docker cho FrankenPHPDocs
-
Laravel ForgeQuản lý server và deployDocs
-
DeployerDeploy không downtime cho PHPDocs
-
Laravel PulseDashboard hiệu năng productionDocs
✅ Tự đánh giá hoàn thành
- Image production tối ưu, chạy user không phải root
- CI/CD tự động, deploy atomic có rollback
- Migration, cache, queue, scheduler được xử lý đúng khi deploy
- Có error tracking, dashboard, alert và postmortem