Trabajos de Trigger.dev

Configuración y ajustes

Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.

1. Abra apps/web/src/job-handlers.ts y apps/web/src/scheduler-runtime.ts en VS Code. Un trabajo es un trabajo de fondo; el planificador decide cuándo ponerlo en cola.

2. Para un tick local, configure el mismo SCHEDULER_TICK_SECRET en apps/web/.env.local y la raíz del repositorio .env; el script de marca lee el .env raíz, mientras que el punto final web lee la configuración de su aplicación.

3. Inicie Web con corepack pnpm --filter @supastack/web dev, luego ejecute corepack pnpm jobs:tick desde la raíz. Se esperaba: el terminal muestra un resultado POST de localhost:3000. Trigger.dev es un proveedor independiente y necesita su propia cuenta y claves de servidor.

Configura JOB_PROVIDER=trigger con TRIGGER_SECRET_KEY y TRIGGER_PROJECT_REF solo del servidor para enviar tareas de producción. Revisa apps/web/trigger.config.ts y la tarea ai.generate en apps/web/trigger antes de configurar el proyecto de destino.

JOB_PROVIDER=trigger
TRIGGER_PROJECT_REF=your-project-reference
# Provide TRIGGER_SECRET_KEY through the server secret store.

Comandos para copiar

Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.

# Terminal 1 — start the Web app from the monorepo root:
corepack pnpm --filter @supastack/web dev

# Terminal 2 — run one scheduler tick from the monorepo root:
corepack pnpm jobs:tick

Flujo de implementación

El contrato compartido de JobRunner garantiza encolado, estado y cancelación. Trigger.dev gestiona la semántica propia del flujo de trabajo; no deduzcas garantías de programación, reintentos o durabilidad de la interfaz genérica.

El ID duradero de tarea de la aplicación conecta el despacho, la ejecución del worker, los registros de uso y los resultados. Si falla la asociación de metadatos de una ejecución del proveedor después de confirmar el encolado, no se debe volver a encolar ni invalidar el trabajo aceptado.

Verificación y solución de problemas

Si la marca devuelve 404, confirme que el secreto existe en ambos archivos de configuración y que coincida exactamente, luego reinicie Web. Si el terminal dice que se rechazó la conexión, primero inicie Web. Si no se ejecutó ningún trabajo, verifique que haya un cronograma habilitado y vencido; un tick no hace que una programación futura se ejecute inmediatamente.

Verifica que el identificador de tarea desplegado y el proyecto coincidan con el entorno configurado. Distingue la aceptación del encolado de la finalización del flujo y de la entrega del correo. Lee docs/production-ai-runtime.md para conocer la recuperación y los diagnósticos seguros antes de reintentar tareas manualmente.