Kostenkalkulation und praktische Migration bei der Einführung von Vercel Workflows
Die Hürde des Serverless-Timeouts und die Berechnung der monatlichen Kosten
Beim Betrieb von SaaS mit Serverless-Funktionen stoßen Entwickler überraschend oft auf das Timeout-Limit von 10 bis 60 Sekunden. Bei der Implementierung von Daten-Backups im großen Stil oder Pipelines zur Erogenerierung multimodaler KI-Medien bricht die herkömmliche Serverless-Umgebung den Code immer wieder ab.
Vercel Workflows hält Aufgaben aufrechter, während der Ressourcenverbrauch auf Null sinkt, sobald eine Funktion in den Wartestatus wechselt. Zur Kostenvorhersage wird direkt ein TypeScript-Skript ausgeführt, um die monatlichen Ausgaben im Voraus zu berechnen. Tägliche Ausführungen, Anzahl der Schritte, Ausführungszeit und Nutzlastgröße werden als Objekte definiert und in eine Kostenberechnungsfunktion übergeben. Wenn das monatliche Limit von 50.000 Events und 1 GB Schreibvorgängen des Hobby-Tarifs überschritten wird, muss ein Upgrade auf Pro frühzeitig eingeplant werden. Bei weniger als 15.000 Ausführungen pro Monat bleibt man im Rahmen der im Pro-Tarif enthaltenen Inklusiv-Guthaben, was kostengünstiger ist als die Aufrechterhaltung einer selbst gehosteten Redis-Infrastruktur.
`typescript
interface WorkflowMetrics {
dailyExecutions: number;
stepsPerExecution: number;
avgStepDurationMs: number;
payloadSizeKb: number;
}
function calculateEstimatedCost(metrics: WorkflowMetrics): { totalEvents: number; estimatedCostUsd: number } {
const totalEvents = metrics.dailyExecutions * metrics.stepsPerExecution * 30;
const freeTierEvents = 50000;
const overageEvents = Math.max(0, totalEvents - freeTierEvents);
const costPerThousand = 0.20;
const estimatedCostUsd = (overageEvents / 1000) * costPerThungk?: number;
return {
totalEvents,
estimatedCostUsd: Number(((overageEvents / 1000) * costPerThousand).toFixed(2))
};
}
`
Schritte beim Übergang von einer Message Queue zum Workflow-SDK
Bei der Verwendung von BullMQ oder AWS SQS mussten Queue-Erstellung, Job-Publishing, Empfang und Redis-Verbindungsverwaltung vollständig manuell implementiert werden. Dieser Prozess bläht den Code unnötig auf. Das Vercel Workflows SDK ersetzt diesen Infrastrukturcode durch direkt in den Code integrierte Anweisungen.
Die Migration erfolgt in drei Schritten. Erstens wird die withWorkflow-Wrapper-Funktion auf die Datei next.config.ts angewendet. Zweitens werden anstelle von herkömmlichen Worker-Prozessen einzelne Aufgaben mithilfe der use step-Anweisung als asynchrone Funktionen geschrieben. Drittens wird die komplexe Parent-Child-Job-Verknüpfung verworfen und stattdessen JavaScript-Kontrollstrukturen sowie die Funktion await sleep innerhalb von use workflow genutzt. Durch das Wegfallen des externen Redis-Verbindungscodes verringert sich der Speicherfootprint der App und die Übergangszeit verkürzt sich.
`typescript
import { workflow } from "@vercel/workflows";
export const { POST } = workflow(async (context) => {
const userId = context.request.payload.userId;
const data = await context.run("fetch-user-data", async () => {
const res = await fetch(https://api.example.com/users/${userId});
return res.json();
});
await context.sleep("wait-for-processing", "10m");
await context.run("finalize-task", async () => {
await db.users.update({ where: { id: userId }, data: { status: "processed" } });
});
});
`
Fehlerbehandlung zur Gewährleistung der Datenintegrität bei Netzwerkabbrüchen
Um Datenverluste bei unvorhersehbaren Fehlern zu verhindern, müssen die Art des Fehlers und seine Merkmale im Vorfeld unterschieden werden. Vercel Workflows behandelt temporäre und kritische Fehler separat.
Um Fehler innerhalb eines Schritts abzufangen, wird bei HTTP-Fehlern der Kategorien 429 oder 500 zunächst ein RetryableError ausgelöst, um Wiederholungsversuche auf Basis eines exponentiellen Backoffs einzuleiten. Zudem wird in Schritten, die Datenbanken modifizieren, eine Logik zur Überprüfung eindeutiger Schlüssel (Unique Keys) eingebaut, um das Ansammeln doppelt vorhandener Daten bei Wiederholungsversuchen zu verhindern. Schließlich werden Vercel Log Drains mit Sentry verbunden, um strukturierte JSON-Logs in Echtzeit zu streamen. Mit diesem Muster wird der Status auch in Ausnahmesituationen ab dem Unterbrechungspunkt wiederhergestellt, sodass manuelle Datenwiederherstellungen überflüssig werden.
`typescript
import { RetryableError } from "@vercel/workflows";
export async function processPaymentStep(context: any, paymentData: any) {
return await context.run("charge-payment", async () => {
const exists = await db.transactions.findUnique({
where: { idempotencyKey: paymentData.key }
});
if (exists) {
return exists;
}
const response = await paymentGateway.charge(paymentData);
if (response.status === 429 || response.status >= 500) {
throw new RetryableError("Payment gateway overloaded, retrying...");
}
return await db.transactions.create({
data: { idempotencyKey: paymentData.key, amount: response.amount }
});
});
}
`