Saltar a contenido

Operación

Deploy

  • Imagen base: dunglas/frankenphp:1-php8.4-alpine.
  • Build en AWS CodeBuild, imagen en ECR y servicio en ECS Fargate.
  • Un solo contenedor con supervisor: Octane, worker sqs-alerts y scheduler.
  • Variables sensibles desde AWS Secrets Manager.
  • php artisan optimize se ejecuta en el entrypoint.

Supervisor

Programa Comando
octane php artisan octane:start --server=frankenphp --host=0.0.0.0 --port=80
queue-worker php artisan queue:work sqs-alerts --tries=3 --timeout=90
schedule php artisan schedule:work

Si el servicio escala a más de una tarea, cada tarea ejecutará el scheduler. Para tareas programadas conviene una sola instancia o locks onOneServer.

Migraciones

Las migraciones se ejecutan en staging antes de promover el cambio. El deploy no las ejecuta automáticamente. No usar migrate:fresh ni migrate:rollback sin autorización.

Colas

Las colas, workers y switches están en Colas y workers.

Alertas

  • ALERTS_ENABLED y alerts.enabled son interruptores.
  • Worker sqs-alerts y cola vortex-play-alerts.
  • Detalle en Alertas.

Verificación posterior al deploy

  1. Login en Admin y Backoffice.
  2. Carga del dashboard y de un reporte.
  3. Una operación de lectura de usuario/agente.
  4. Revisar logs (storage/logs/laravel.log) y errores 5xx.
  5. Confirmar que el worker sqs-alerts consume sin errores.
  6. Revisar cabeceras de seguridad si el deploy las tocó.

Troubleshooting

En Troubleshooting.

Documentación relacionada