Allgemeine Zwänge

Sehen Sie sich die allgemeinen Einschränkungen an, die für alle Konfigurationen einer schrittweisen Einführung gelten. Diese Einschränkungen gewährleisten einen ordnungsgemäßen Betrieb und verhindern Konflikte mit anderen Funktionen.

• Enterprise-Tier erforderlich: Der schrittweise Rollout ist nur für Benutzer der Enterprise-Stufe verfügbar.
• Ein Rollout pro Flagge: Pro Merkmalskennzeichen ist nur ein progressiver Rollout erlaubt. Sie können sie auf der Ebene der Kennzeichen oder auf der Ebene der Regeln konfigurieren, aber nicht beides gleichzeitig.
• Jeweils eine aktive Bereitstellungsstrategie: Wenn ein Experiment auf einer Flagge läuft, können Sie keinen progressiven Rollout erstellen. Ähnlich verhält es sich, wenn ein progressiver Rollout läuft, können Sie kein Experiment mit dieser Flagge starten.
• Prozentualer Bereich: Der Prozentsatz des Rollouts muss zwischen 1% und 100% liegen.

API-Anforderungen nach Anwendungsbereich

Welche API Sie verwenden, hängt vom Umfang Ihrer Konfiguration für die schrittweise Einführung ab. Wählen Sie die passende API aus, je nachdem, wo Sie die Einführung konfigurieren.

• Progressiver Rollout auf Flaggenebene: Verwenden Sie die Feature-Flag-API, um den Rollout zu erstellen und zu aktualisieren.
• Progressiver Rollout auf Regelebene: Verwenden Sie die Regel-API, um den Rollout zu erstellen und zu aktualisieren.
• Anhalten eines Rollouts: Verwenden Sie die APIs zum Anhalten eines Rollouts, um ein aktives progressives Rollout anzuhalten.

Konfigurationsanforderungen nach Umfang

Bevor Sie eine schrittweise Einführung konfigurieren, stellen Sie sicher, dass Ihr Flag oder Ihre Regel explizite Einführungswerte anstelle von vererbten Werten verwendet. Diese Anforderung verhindert Konflikte und gewährleistet, dass die schrittweise Einführung vollständig kontrolliert erfolgt.

• Bei progressivem Rollout auf Flaggenebene: Keine der Ausrichtungsregeln kann einen vom Flag geerbten Wert rolloutPercentage haben. Alle Ausrichtungsregeln müssen überschriebene Rollout-Werte verwenden.
• Bei progressivem Rollout auf Regelebene: Die Zielregel, zu der Sie das Rollout hinzufügen, kann keinen Wert verwenden, der vom Kennzeichen geerbt wurde. Die Regel muss einen eigenen expliziten Wert haben.

Blockierte Vorgänge während des progressiven Rollouts

Befindet sich ein schrittweiser Rollout im laufenden Zustand, werden bestimmte Vorgänge gesperrt, um die Integrität des Rollouts zu gewährleisten und Konflikte zu vermeiden.

• Erstellen eines weiteren progressiven Rollouts: Pro Flagge ist nur ein progressiver Rollout erlaubt.
• Starten eines Experiments: Experimente können nicht mit Flaggen durchgeführt werden, die bereits einen progressiven Rollout laufen haben.
• Löschung einer Sammlung: Das Löschen einer Sammlung ist blockiert, wenn ein zugehöriges Merkmalskennzeichen einen progressiven Rollout im laufenden Zustand hat.
• Aktualisieren oder Löschen eines Segments: Segmentaktualisierungen und -löschungen werden blockiert, wenn ein zugehöriges Feature-Flag einen progressiven Rollout im laufenden Zustand hat.
• Ändern der Konfiguration des Kennzeichens oder der Regel: Aktualisierungen des Kennzeichens oder der Zielregel, die das Rollout verwendet, sind nur zulässig, wenn das progressive Rollout nicht ausgeführt wird.

Verhalten im Lebenszyklus

Wenn Sie das Verhalten im Lebenszyklus verstehen, können Sie die Wechselwirkungen zwischen schrittweisen Rollouts und anderen Funktionen besser steuern. „ App Configuration “ sorgt für eine strikte Trennung zwischen den Bereitstellungsstrategien.

• Wenn ein Experiment läuft, können Sie kein progressives Rollout erstellen.
• Wenn ein progressiver Rollout läuft, können Sie kein Experiment mit der gleichen Flagge starten.
• Um einen Rollout zu stoppen, müssen Sie die speziellen APIs zum Stoppen von Rollouts verwenden.

Konfigurieren der progressiven Ausrollung auf Flaggenebene

So konfigurieren Sie den progressiven Rollout auf der Flaggenebene:

1. Navigieren Sie in der Konsole App Configuration zu Feature-Flags.
2. Wählen Sie die Umgebung aus, die Ihr Feature-Flag enthält.
3. Klicken Sie auf das Merkmalskennzeichen, das Sie konfigurieren möchten.
4. Wählen Sie im Abschnitt Feature-Rollout die Option Progressiv als Rollout-Typ.
5. Konfigurieren Sie die Rollout-Einstellungen:
   • Voreingestellte Dauer: Wählen Sie aus vordefinierten Vorlagen ( 1hr, 12hr, 24hr, 48hr ) oder wählen Sie Benutzerdefiniert
   • Phasen: Definieren Sie jede Phase mit einem Prozentsatz und einer Dauer
   • Später einplanen (optional): Schalten Sie diese Option ein, um eine Startzeit in UTC für den Rollout festzulegen. Wenn diese Option nicht aktiviert ist, beginnt der Rollout sofort.
6. Klicken Sie auf Speichern.

Der progressive Rollout beginnt automatisch zur konfigurierten Startzeit.

Konfigurieren des progressiven Rollouts auf Regelebene

So konfigurieren Sie den progressiven Rollout auf der Ebene der Zielsetzungsregeln:

1. Navigieren Sie in der Konsole App Configuration zu Feature-Flags.
2. Wählen Sie die Umgebung aus, die Ihr Feature-Flag enthält.
3. Klicken Sie auf das Merkmalskennzeichen, das Sie konfigurieren möchten.
4. Wählen Sie im Abschnitt „Targeting“ die Regel aus, die Sie konfigurieren möchten.
5. Stellen Sie sicher, dass die Regel einen überschriebenen Wert hat.
6. Wählen Sie im Abschnitt Rollout der Regel die Option Progressiv als Rollout-Typ.
7. Konfigurieren Sie die Rollout-Einstellungen:
   • Voreingestellte Dauer: Wählen Sie aus vordefinierten Vorlagen ( 1hr, 12hr, 24hr, 48hr ) oder wählen Sie Benutzerdefiniert
   • Phasen: Definieren Sie jede Phase mit einem Prozentsatz und einer Dauer
   • Später einplanen (optional): Schalten Sie diese Option ein, um eine Startzeit in UTC für den Rollout festzulegen. Wenn diese Option nicht aktiviert ist, beginnt der Rollout sofort.
8. Klicken Sie auf Speichern.

Konfiguration der Phasen

Legen Sie den Prozentsatz und die Dauer für jede Phase Ihrer schrittweisen Einführung fest. Jede Phase besteht aus zwei Schlüsselkomponenten, die den Fortschritt der Einführung steuern.

Jede Phase umfasst:

• Prozentsatz: Der Prozentsatz der Nutzer, die den aktivierten Wert erhalten (1-100%)
• Dauer: Wie lange diese Phase dauern soll (z. B. " 8h ", " 30m ", " 2d ")

Die letzte Phase erfordert keine Dauer, da sie den Abschlusszustand darstellt.

Beispiele für Phasen

Sehen Sie sich diese Beispiele für Konfigurationen der schrittweisen Einführungsphasen für verschiedene Szenarien an.

Beispiel 1: Schrittweise Einführung der 24-Stunden-Regelung

{
  "phases": [
    { "percentage": 5, "duration": "6h" },
    { "percentage": 25, "duration": "6h" },
    { "percentage": 50, "duration": "6h" },
    { "percentage": 100, "duration": "6h" }
  ]
}

Beispiel 2: Schnelle 1-Stunden-Einführung

{
  "phases": [
    { "percentage": 10, "duration": "15m" },
    { "percentage": 50, "duration": "15m" },
    { "percentage": 100, "duration": "30m" }
  ]
}

Beispiel 3: Konservative 48-Stunden-Einführung

{
  "phases": [
    { "percentage": 5, "duration": "12h" },
    { "percentage": 10, "duration": "12h" },
    { "percentage": 25, "duration": "12h" },
    { "percentage": 100, "duration": "12h" }
  ]
}

Im Rahmen eines Rollouts

Im Rahmen einer einzigen schrittweisen Einführung sorgt „ App Configuration “ für einheitliche Zuweisungen für jeden Nutzer, um in allen Phasen ein stabiles Nutzererlebnis zu gewährleisten.

• Die Zufallsgenerierung ist deterministisch, siehe entity_id.
• Die gleiche „ entity_id “ erhält immer denselben Auftrag.
• Benutzer, die den aktivierten Wert in Phase 1 erhalten, erhalten ihn auch in den nachfolgenden Phasen weiterhin.
• Mit steigendem Prozentsatz kommen neue Nutzer hinzu.

Über Rollouts hinweg

Wenn Sie eine neue schrittweise Einführung für denselben Flag starten, generiert „ App Configuration “ eine neue Verteilung, um unterschiedliche Nutzungsmuster der Benutzer zu ermöglichen.

• Es wird eine neue Zufallsverteilung generiert.
• Derselbe „ entity_id “ kann einen anderen Auftrag erhalten.
• Auf diese Weise können verschiedene Benutzergruppen in unterschiedlichen Einführungsphasen einbezogen werden.