Introdução: por que implantar PHP no Kubernetes?
O PHP continua sendo uma das linguagens mais populares para desenvolvimento web. No entanto, à medida que a carga e a complexidade dos projetos (Laravel, Symfony, Bitrix) aumentam, a pilha LAMP tradicional deixa de ser suficiente. O Kubernetes (K8s) oferece uma solução: escalonamento automático, tolerância a falhas, implantação com zero downtime e gerenciamento de configurações.
Neste guia, vamos analisar na prática o ciclo completo de implantação de uma aplicação PHP no Kubernetes: desde a criação da imagem Docker até a configuração do Ingress. Você aprenderá como preparar manifestos, gerenciar variáveis de ambiente e garantir o funcionamento do PHP-FPM no cluster.
1. Preparação da aplicação PHP e imagem Docker
1.1. Estrutura do projeto PHP
Para a implantação, precisaremos de uma aplicação PHP mínima. Vamos usar o clássico index.php:
<?php// index.phpecho "Hello from Kubernetes! PHP version: " . phpversion();Também criaremos um composer.json (se estiver usando um framework):
{ "require": { "php": "^8.1" }}1.2. Dockerfile para PHP-FPM
Ponto chave: no Kubernetes, o PHP funciona através do PHP-FPM, e o Nginx serve os arquivos estáticos. Vamos criar o Dockerfile:
FROM php:8.2-fpm-alpine
# Instalação das extensões necessáriasRUN docker-php-ext-install pdo_mysql mysqli opcache
# Copia o código da aplicaçãoCOPY . /var/www/html
# Permissões de acessoRUN chown -R www-data:www-data /var/www/html
# Configurações do PHPCOPY php.ini /usr/local/etc/php/conf.d/custom.ini
WORKDIR /var/www/html
EXPOSE 9000CMD ["php-fpm"]Para produção, adicione opcache:
; php.iniopcache.enable=1opcache.memory_consumption=128opcache.max_accelerated_files=100001.3. Dockerfile para Nginx
O Nginx fará proxy das requisições para o PHP-FPM:
FROM nginx:alpine
COPY nginx.conf /etc/nginx/conf.d/default.confCOPY public/ /var/www/html/public
EXPOSE 80Exemplo de nginx.conf:
server { listen 80; root /var/www/html/public; index index.php;
location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ \\.php$ { fastcgi_pass php-service:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }}2. Criação dos manifestos Kubernetes
2.1. Namespace
Vamos isolar nossa aplicação:
apiVersion: v1kind: Namespacemetadata: name: php-app2.2. ConfigMap para variáveis de ambiente
Aplicações PHP frequentemente usam variáveis de ambiente (por exemplo, para conexão com o banco de dados):
apiVersion: v1kind: ConfigMapmetadata: name: php-config namespace: php-appdata: APP_ENV: production APP_DEBUG: "false" DB_HOST: mysql-service2.3. Secret para dados sensíveis
Senhas e chaves são armazenadas no Secret:
apiVersion: v1kind: Secretmetadata: name: php-secrets namespace: php-apptype: Opaquedata: DB_PASSWORD: cGFzc3dvcmQxMjM= # base64 "password123"2.4. Deployment para PHP-FPM
O componente principal — PHP-FPM:
apiVersion: apps/v1kind: Deploymentmetadata: name: php-deployment namespace: php-appspec: replicas: 2 selector: matchLabels: app: php-app template: metadata: labels: app: php-app spec: containers: - name: php-fpm image: my-registry/php-app:latest ports: - containerPort: 9000 envFrom: - configMapRef: name: php-config - secretRef: name: php-secrets resources: requests: memory: "128Mi" cpu: "250m" limits: memory: "256Mi