Imagen base SIU para PHP

Este repositorio contiene el código necesario para construir imágenes de contenedores basadas en php en diferentes versiones del lenguaje:

• 8.0 (deprecada)
• 8.1
• 8.2
• 8.3

En cada versión, se proveen versiones para:

• cli: intérprete de php para utilizarse en scripts que no requieran un web server.

• web: igual imagen que la cli, pero agrega el servicio de apache2 y configura el módulo de apache para integrarse con PHP. En este caso, se instancia automáticamente el servicio de apache en foreground y los logs se redirigen a la salida estándar.

• web-rootless: igual a la web, pero corre con un usuario no privilegiado.

• Acerca del entrypoint

• Imagen Rootless

• Usos de la imagen

  • Extendiendo configuraciones con volúmenes locales
  • Extendiendo configuraciones con build de imagen

Acerca del entrypoint

El entrypoint en la imagen cli se hereda de la imagen base, siendo un shell. Para el servicio web, es el servicio de apache el que tendrá el pid 1. Sin embargo, previo a su invocación, se recorren todos los scripts que se desee agregar para correr antes de iniciar el servicio.

Puerto de ejecución

Para la ejecución del proceso Apache, se opta por utilizar el puerto 8080, ya que se trata de un puerto no privilegiado (tal como 1 a 1024). Esto nos permite contar con la posibilidad de ejecutar la imagen en modo Rootless (ver abajo), sin necesidad de agregar "capacidades" extra que pueden ser excluídas por cuestión de seguridad en otros entornos.

Imagen Rootless

Esta imagen utiliza un usuario no privilegiado para correr. La imagen crea un usuario que por defecto se parametriza es siu

Usos de la imagen

La imagen puede extenderse mediante configuraciones que deban agregarse a php o apache, como además agregando fuentes, instalando librerías, y demás cuestiones que serán necesarias según el proyecto que deba emplear la imagen. Por ello, cada escenario será muy particular y podrá seguir alguna de las prácticas debajo mencionadas:

Extendiendo configuraciones con volúmenes locales

Esta práctica aplica a volumenes desde el filesystem, pero también aplica a swarm configs, secrets o kubernetes configmap o secrets.

Para poder mostrar como parametrizar un valor del php.ini, cambiaremos la configuración de memory_limit. Primero verificamos el valor actual:

docker run --rm \
  siudocker/php:8.2-cli-v1.0.3 php -r 'echo ini_get("memory_limit")."\n";'

Usando un volumen:

echo "memory_limit = 64M" > /tmp/custom.ini && \
  docker run \
    -v /tmp/custom.ini:/etc/php81/conf.d/90-custom.ini \
    --rm \
    siudocker/php:8.2-cli-v1.0.3 php -r 'echo ini_get("memory_limit")."\n";'

Usando un config de swarm:

# Crea un ini custom
echo "memory_limit = 64M" > /tmp/custom.ini

# Creamos un stack de swarm
cat <<COMPOSE > /tmp/siu-stack.yml
version: "3.9"
services:
  web:
    image: siudocker/php:8.2-web-v1.0.3
    deploy:
      replicas: 1
    configs:
      - source: siu-demo-ini
        target: /etc/php81/conf.d/99-custom.ini
configs:
  siu-demo-ini:
    file: /tmp/custom.ini
COMPOSE

# Asumimos ya existe un cluster swarm. Entonces cargamos este stack de ejemplo
docker stack deploy --compose-file /tmp/siu-stack.yml siu

# Verificamos el valor del php.ini
docker exec -it $(docker ps -q -f name=siu_web) \
  php -r 'echo ini_get("memory_limit");'

Extendiendo configuraciones con build de imagen

Podemos crear una nueva imagen a partir de alguna de las imagenes de base, y cargar cuantas personalizaciones querramos.

Si las personalizaciones dependen en runtime, se debe pensar poder parametrizarlas desde variables de ambiente o usando alguna estrategia como las mencionadas arriba

Un ejemplo de agregar una personalización sería:

FROM siudocker/php:8.2-web-v1.0.3

COPY ./custom.ini /etc/php81/conf.d/99-custom.ini