durable-objects

durable-objects ist der offizielle Cloudflare-Skill für die Entwicklung, Fehlersuche und Prüfung von Durable-Objects-Anwendungen. Die kanonische SKILL.md liegt im offiziellen Repository cloudflare/skills unter skills/durable-objects. Laut Anbieter helfen Durable Objects dabei, zustandsbehaftete Anwendungen am Edge zu koordinieren. Der Skill ist eine Arbeitsanweisung für kompatible Coding-Agenten, kein eigener Cloudflare-Account, kein Ersatz für Workers und keine Laufzeitbibliothek. Für das aktuelle Plattformverhalten verweist die Primärquelle ausdrücklich auf die offizielle Dokumentation, weil APIs und Konfigurationen sich weiterentwickeln können.

Zweck und Produktgrenze

Die Anleitung eignet sich für Chat-Räume, Multiplayer-Anwendungen, kollaborative Dokumente, Buchungs- und Inventarsysteme, mandantenbezogenen Zustand, WebSockets sowie geplante Arbeit pro Entität. Ihr Kern ist die Modellierung eines Koordinationsatoms: Ein Durable Object soll beispielsweise einen Raum, ein Spiel oder einen Nutzer repräsentieren, statt alle Anfragen in einem einzigen globalen Objekt zu bündeln. Die Quelle nennt außerdem RPC-Methoden, Alarme, SQLite-Speicher, Bindings, Migrationen, Sharding und Eltern-Kind-Beziehungen als typische Prüfbereiche. Stateless HTTP-Verarbeitung, maximale globale Verteilung und unabhängige Anfragen mit hoher Fan-out-Rate gehören dagegen eher zu anderen Cloudflare-Werkzeugen. Diese Abgrenzung verhindert, dass der Skill jede Worker-Anwendung pauschal als Durable-Objects-Projekt behandelt.

Arbeitsweise und Architektur

Laut Anbieter soll ein Agent zuerst die aktuelle Dokumentation abrufen und anschließend die vorhandene Projektkonfiguration, die installierten Typen und die gewählte Speichertechnik prüfen. Für deterministisches Routing empfiehlt die Quelle getByName, während bestehende IDs oder bewusst erzeugte eindeutige IDs andere begründete Fälle abdecken. Neue Klassen sollen SQLite-Migrationen korrekt konfigurieren, und die Initialisierung des Schemas soll mit blockConcurrencyWhile auf den Konstruktor begrenzt bleiben. Kritische Daten gehören zuerst in dauerhaften Speicher; ein In-Memory-Cache muss aus diesem Speicher wiederherstellbar sein. RPC-Methoden sind für unterstützte Kompatibilitätsdaten die bevorzugte Schnittstelle, während externe I/O innerhalb von Sperren und eine globale Objektinstanz als Engpässe vermieden werden sollen. Ein Alarm ersetzt einen vorhandenen Alarm desselben Objekts, weshalb Planung, Wiederholung und Abbruch bewusst getestet werden müssen.

Tests und Betrieb

Die offizielle Referenz verweist für neue und bestehende Projekte auf Cloudflare's Vitest-Integration für Workers. Ein sinnvoller Test prüft nicht nur eine erfolgreiche Antwort, sondern auch, dass ein Objekt seinen Zustand über mehrere Aufrufe behält, unterschiedliche Identitäten getrennt bleiben und SQLite-Daten tatsächlich die versprochene Persistenz abbilden. Für Alarme sollen die dokumentierten Testhilfen verwendet werden, statt auf Echtzeitabläufe zu warten. Vor einer Migration sind die bereits installierten Vitest-, Wrangler- und Cloudflare-Pakete sowie die Konfiguration zu prüfen. Der Skill ersetzt weder eine vollständige Lastprüfung noch Monitoring, Backup-Planung, Datenschutzbewertung oder eine menschliche Freigabe für produktive Änderungen.

Sicherheit und E-E-A-T

Diese Beschreibung stützt sich auf die versionierte SKILL.md im offiziellen Cloudflare-Repository und auf die offiziellen Durable-Objects-Dokumente zu Konzepten, API, Migrationen, Speicher, Best Practices und Tests. Cloudflare ist laut Anbieter der Betreiber der beschriebenen Plattform; die Repository-Lizenz ist laut offizieller Quelle Apache-2.0. Durable Objects können persistente Zustände und Verbindungen verwalten, weshalb Datenmodell, Zugriffsschutz, Löschkonzept, Fehlerbehandlung und Standortanforderungen fachlich geprüft werden müssen. Der Skill enthält keine Zugangsdaten und keine gefährlichen Befehle. Ein lokaler Agent macht die Verarbeitung nicht automatisch vertraulich: Der ausgewählte Modellanbieter kann Projektdateien und Ergebnisse verarbeiten, während Cloudflare abhängig von Dienst und Konfiguration Requests, Logs und Zustände verarbeitet. Aktuelle Grenzen und Anbieterbedingungen sind direkt bei Cloudflare zu prüfen.