Trigger.dev-jobs

Setup en configuratie

Lees vóór elke stap Voordat u begint en Basisbeginselen van de terminal. Deze instructies gaan ervan uit dat je de volledige supastack monorepo in VS Code hebt geopend; zijn root package.json markeert de root van de repository. In pnpm-opdrachten is een werkruimtepakket een app of map met gedeelde code; in het product is een werkruimte de gegevenscontainer en de beveiligingsgrens van een team. corepack pnpm --filter ... selecteert één pakket uit de monorepo terwijl opdrachten vanuit de root worden uitgevoerd. Als u alleen een gesynchroniseerde mobiele map of desktopmap hebt geopend, bevat deze niet de webbackend, Docker-installatie of rootscripts: voer de backend uit vanaf deze monorepo of een bereikbare gehoste server en gebruik de eigen scripts van de platformmap. Een omgevingsvariabele is een benoemde instelling die is opgeslagen in een lokaal .env-bestand of op uw hostingdashboard; start de relevante app opnieuw nadat u deze hebt gewijzigd en houd servergeheimen buiten de NEXT_PUBLIC_- en EXPO_PUBLIC_-waarden.

1. Open apps/web/src/job-handlers.ts en apps/web/src/scheduler-runtime.ts in VS Code. Een baan is achtergrondwerk; de planner beslist wanneer deze in de wachtrij moet worden geplaatst.

2. Voor een lokaal vinkje stelt u dezelfde SCHEDULER_TICK_SECRET in in apps/web/.env.local en de repository-root .env; het tick-script leest de root .env, terwijl het webeindpunt de app-instellingen leest.

3. Start Web met corepack pnpm --filter @supastack/web dev en voer vervolgens corepack pnpm jobs:tick uit vanuit de root. Verwacht: de terminal toont een POST-resultaat van localhost:3000. Trigger.dev is een aparte provider en heeft zijn eigen account- en serversleutels nodig.

Zet JOB_PROVIDER=trigger met server-only TRIGGER_SECRET_KEY en TRIGGER_PROJECT_REF voor productietaaksubmission. Review apps/web/trigger.config.ts en de ai.generate-taak in apps/web/trigger voordat je het doelproject configureert.

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

Commando's om te kopiëren

Volg de opmerkingen om te zien in welke map een opdracht wordt uitgevoerd. Als twee terminals zijn gelabeld, opent u twee terminalvensters en laat u de eerste opdracht draaien terwijl u de tweede gebruikt.

# 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

Implementatieworkflow

Het gedeelde JobRunner-contract belooft enqueue, status en cancel. Trigger.dev bezit workflowspecifieke semantiek; leid geen scheduling-, retry- of duurzaamheidsgaranties af uit het generieke interface.

De duurzame applicatietaak-ID verbindt dispatch, worker-executie, usagerecords en resultaten. Een gefaalde metadata-attachment na bevestigde enqueue mag geen nieuwe enqueue veroorzaken of geaccepteerd werk invalideren.

Verificatie en probleemoplossing

Als het vinkje 404 retourneert, bevestig dan dat het geheim in beide instellingenbestanden bestaat en exact overeenkomt, en start Web vervolgens opnieuw. Als de terminal zegt dat de verbinding is geweigerd, start dan eerst Web. Als er geen taak is uitgevoerd, controleer dan of er een schema is ingeschakeld en klaar is; één vinkje zorgt er niet voor dat een toekomstig schema onmiddellijk wordt uitgevoerd.

Verifieer dat de gedeployde taakidentificatie en het project overeenkomen met de geconfigureerde omgeving. Scheid enqueue-acceptatie van workflowvoltooiing en van e-mailaflevering. Lees docs/production-ai-runtime.md voor recovery en veilige diagnostiek voordat je werk handmatig opnieuw probeert.