Rollouts

Ein Rollout ist ein benannter Stapel von Datensatzversionen mit einem geplanten Zeitpunkt. In diesem Moment veröffentlicht er die genannte Version jedes Datensatzes, sodass eine Kampagne über viele Datensätze gemeinsam live geht.

Was ein Rollout enthält

Ein Rollout hat einen Namen, einen geplanten Zeitpunkt und eine Liste von Datensatzversionen. Der Zeitpunkt ist erforderlich, und solange das Rollout noch geplant ist, können Sie seinen Namen, seine Beschreibung, seinen Zeitpunkt und seine Einträge bearbeiten.

Es enthält nur Datensatzversionen. Änderungen an Modellen und Konfiguration gehören in ein Release, und ein Rollout kann ein geplantes Release nennen, das zuerst ausgeliefert wird. Das Release geht dann im Moment des Rollouts raus, vor den Inhalten. Wird es abgelehnt oder schlägt fehl, wird das Rollout mit dem Grund als fehlgeschlagen markiert, und keiner seiner Inhalte wird veröffentlicht.

Was geschieht, wenn ein Eintrag fehlschlägt

Alle Einträge laufen in einer Datenbanktransaktion, jeder unter einem eigenen Savepoint. Ein Eintrag, der fehlschlägt, wird für sich zurückgerollt und als fehlgeschlagen vermerkt. Die anderen werden trotzdem veröffentlicht und werden gemeinsam sichtbar, wenn die Transaktion committet. Danach steht das Rollout auf Abgeschlossen, wenn jeder Eintrag erfolgreich war, auf Teilweise, wenn einige fehlgeschlagen sind, und auf Fehlgeschlagen, wenn alle fehlgeschlagen sind.

Die Steuerungen

Ein geplantes Rollout kann vorzeitig ausgelöst, pausiert und fortgesetzt werden, und es kann gelöscht werden, bis es ausgelöst wurde. Die Wiederholung führt nur die fehlgeschlagenen Einträge erneut aus. Der Rollback veröffentlicht die zuvor veröffentlichte Version jedes Eintrags erneut. Sie können einen Rollback vor der Ausführung in der Vorschau ansehen, und die Vorschau weist auf jeden Eintrag hin, der keine frühere veröffentlichte Version hat.

Wo Sie sie verwalten

Rollouts werden in der Konsole unter Inhalte, Geplant, Rollouts verwaltet, über die CLI mit foir rollouts, und über Agent-Tools. Die öffentliche GraphQL-API verwaltet sie nicht. Für CI ist das dokumentierte Muster ein geplanter Job, der das Rollout mit der CLI aus einer Datei erstellt. Das Erstellen setzt die Berechtigung schedules:write voraus.

Details nachlesen

Der Leitfaden zur geplanten Veröffentlichung behandelt das Anlegen eines Rollouts, seine Status und jede Lifecycle-Steuerung.