Skip to main content

Was sind Rollout-Regeln?

Der Rollout Planner gibt Ihnen granulare Kontrolle über Ihre Releases und Tests. Sie können jeden Feature Flag jederzeit für bestimmte Nutzer aktivieren oder deaktivieren. Rollout-Regeln sind wie bedingte Anweisungen für Ihre Releases und Experimente. Sie können eine Abfolge von Aktionen einrichten, die unter bestimmten Bedingungen ausgelöst werden. Sie können diese Regeln planen, sofort anwenden, auf bestimmte Gruppen ausrichten, neu ordnen und anpassen, um sie an Ihren Zielen auszurichten.

Eine neue Regel hinzufügen

Klicken Sie auf Add a rule, um das Konfigurationsmenü für die Regel zu öffnen. Hier können Sie zwischen Bereitstellungs- oder Test-Regeln wählen und Ihre Regel benennen.
Sie können Regeln jeglicher Art kombinieren, um die Rollout-Strategie Ihres Features umzusetzen. Kameleoon ermöglicht es Ihnen, Regeln für Targeted Delivery, Progressive Delivery und Feature Experiments hinzuzufügen.

Wie funktioniert die Regel-Warteschlange?

Sobald Sie Ihre Rollout-Regeln hinzugefügt haben, ist es wichtig zu verstehen, wie Kameleoon die Warteschlange auswertet:
  • Kameleoon prüft, ob Ihr Flag ein- oder ausgeschaltet ist. Wenn es ausgeschaltet ist, sehen die Besucher die Standardvariation (die Sie in der Dropdown-Liste „Then, for everyone else in production, serve” auswählen können).
  • Wenn das Flag eingeschaltet ist, wertet Kameleoon die Experimente und Regeln in der Warteschlange von oben nach unten aus. Behalten Sie die Auswertungsreihenfolge bei der Planung Ihrer Rollout-Strategie im Hinterkopf, um unvorhergesehene Targeting-Überschneidungen zu vermeiden.
  • Neue Regeln werden standardmäßig am unteren Ende der Warteschlange hinzugefügt. Sie können Regeln jedoch manuell neu anordnen, indem Sie deren Karte anklicken und an eine neue Position ziehen. Das Neuanordnen von Regeln in der Warteschlange ändert auch die Reihenfolge, in der Kameleoon die Regel liest und auswertet. Seien Sie achtsam, wenn Sie Regeln bereitstellen, die dieselbe Zielgruppe teilen.
  • Kameleoon ignoriert pausierte Regeln einfach zur Laufzeit.

Benutzer-Targeting und Bucketing

Das Aussetzen eines Benutzers gegenüber einer Variation folgt einem zweistufigen Prozess: Targeting und Bucketing. Targeting bedeutet, dass der Benutzer die in einer Regel angegebenen Bedingungen erfüllt. Bucketing bedeutet, dass Kameleoon den Benutzer der mit dieser Regel verknüpften Variation zugewiesen hat. Kameleoon behandelt Targeting und Bucketing für Bereitstellungs- und Experimentregeln unterschiedlich. Betrachten Sie diese beiden Szenarien:

Szenario 1: Bereitstellungsregel ganz oben

Wenn Kameleoon einen Besucher zunächst für eine Targeted/Progressive Delivery-Regel ins Visier nimmt:
  • Er erhält die ausgewählte Variation, wenn Kameleoon ihn bucketet.
  • Wenn er ins Visier genommen, aber nicht gebucketed ist, erhält der Besucher die „Everyone else”-Variation, und Kameleoon wertet ihn für keine andere Regel aus.

Szenario 2: Experimentregel ganz oben

  • Wenn Kameleoon einen Besucher mit einer Experimentregel anvisiert:
    • Er erhält die ausgewählte Variation, wenn Kameleoon ihn bucketet.
    • Wenn Kameleoon ihn anvisiert, aber nicht bucketet, überprüft Kameleoon die nächste Regel, bis das Ende der Warteschlange erreicht ist. Alle Benutzer, die Experimentregeln nicht bucketen, rücken in der Warteschlange nach unten. Aus diesem Grund ist es immer eine gute Praxis, Experimente oben in Ihrer Warteschlange zu behalten.
Eine Änderung der Traffic-Aufteilung für ein Experiment ändert nicht die Gesamtgröße Ihres Experiment-Buckets. Angenommen, Sie starten ein Experiment, das 20 % eines Benutzersegments mit einer Variations-Aufteilung von 50/50 für seine beiden Variationen anvisiert. Wenn Sie die Aufteilung auf 60/40 oder 90/10 ändern, aber den Prozentsatz des Traffics, der in die Experimentstichprobe einbezogen wird (20 %), nicht ändern, nehmen die insgesamt gebucketed Benutzer weder zu noch ab. Stattdessen werden einige gebucketed Benutzer einer anderen Variation ausgesetzt.
Wenn keine weiteren Regeln in der Warteschlange vorhanden sind, erhalten alle verbleibenden Benutzer die „Everyone else”-Variation.

Regelstatus

Alle Regeln in der Warteschlange zeigen einen dieser Status an:
  • Active (ist live)
  • Paused
  • Planned (geplant, zu einem bestimmten Datum/Uhrzeit zu starten und/oder zu stoppen). Eine geplante Regel wechselt zum festgelegten Zeitplan auf active oder am Ende auf outdated.
  • Unsaved changes (dies umfasst auch neue Regeln im Entwurfszustand)
  • Outdated (eine geplante Regel, die zum geplanten Enddatum automatisch deaktiviert wurde). Die Standardansicht blendet veraltete Regeln aus, aber Sie können Filter verwenden, um sie anzuzeigen.

Eine Regel pausieren oder fortsetzen

Um eine Regel zu pausieren, klicken Sie auf das Drei-Punkte-Menü auf der Karte eines Experiments und klicken Sie auf Pause.
Kameleoon ignoriert pausierte Regeln zur Laufzeit. Sie können die Regel später im selben Menü fortsetzen.

Regeln aus einer anderen Umgebung kopieren

Sie können auch Regeln hinzufügen, die Sie in einer anderen Umgebung erstellt haben. Das Kopieren von Regeln ermöglicht es Ihnen, Ihre Rollout-/Experiment-Konfiguration zum Beispiel von Ihrer staging-Umgebung in Ihre production-Umgebung zu replizieren.
Wählen Sie Copy beim Hinzufügen von Regeln in Ihrer Zielumgebung und wählen Sie im nächsten Schritt die Quellumgebung aus. Sie haben die Möglichkeit, die kopierten Regeln am Ende Ihrer Regel-Warteschlange anzuhängen oder alle bestehenden Regeln durch die kopierten Regeln zu ersetzen.

Rollout-Zusammenfassung

Dieser Abschnitt bietet einen Überblick über Variationen und Segmente. Das Ändern der Kartenreihenfolge, das Löschen einer Regel oder das Ändern des Status einer Regel wirkt sich auf die Sortierung und die Werte in den Zusammenfassungskarten aus. Während der Zusammenfassungsabschnitt nicht anvisierte (verbleibende) Benutzer berücksichtigt, die Kameleoon an die nächste Regel weitergeben kann, berücksichtigt oder identifiziert er teilweise oder vollständige Überschneidungen zwischen verschiedenen Benutzersegmenten in verschiedenen Regeln nicht.

Zusammenfassung der Variationen

Dieser Abschnitt bietet einen Überblick darüber, welche Variationen Ihre Bereitstellungs- und Experimentregeln verwendet haben. Variationen, die mehrere Segmente anvisieren, haben mehrere Balken, die den Prozentsatz der von Ihnen anvisierten Zielgruppe anzeigen.

Zusammenfassung der Segmente

Dieser Abschnitt fasst die verschiedenen Benutzersegmente zusammen, die Ihre Rollout-Regeln anvisieren. Variationen, die einem Segment zugewiesen sind, kombinieren sich, um maximal 100 % zu erreichen. Wenn Sie dieses Limit überschreiten, ignoriert Kameleoon verbleibende Variationen.

Verwendung des Rollout Planners mit veralteten SDKs

Wenn die Version Ihres SDK keine Feature Variations unterstützt, müssen Sie einige Punkte beachten, wenn Sie neue Regeln für ein Feature Flag hinzufügen:
  • Kameleoon überprüft nur die in der Production-Umgebung definierten Regeln und ignoriert Regeln, die Sie in der staging- oder development-Umgebung erstellt haben.
  • Kameleoon wertet nur die erste Regel in der Warteschlange aus und ignoriert alle weiteren Regeln darunter. Wenn überhaupt keine Regeln vorhanden sind, liefert Kameleoon die in Ihrem Rollout definierte Standardvariation aus.
  • Kameleoon unterstützt nur die Standardvariationen On und Off.
  • Kameleoon unterstützt keine Start-/Stopp-Planung von Regeln.
Besuchen Sie das Github von Kameleoon und abonnieren Sie Benachrichtigungen, um über alle SDK-Releases auf dem Laufenden zu bleiben.