Feature-Flag erstellen

Führen Sie die folgenden Schritte aus, um ein Feature-Flag zu erstellen:

1. Klicken Sie in der App Configuration-Konsole auf Feature-Flags.

2. Wählen Sie Aktuelle Umgebung aus, um die Liste der Feature-Flags in dieser Umgebung anzuzeigen.

3. Klicken Sie auf Erstellen. Es öffnet sich ein Seitenbereich mit Feldern zum Erstellen eines neuen Feature-Flags.

   

4. Geben Sie die Details des Feature-Flags an:

   • Name - Name des Feature-Flags.
   • Feature-Flag-ID - Der Wert für die Feature-Flag-ID wird basierend auf dem eingegebenen Feature-Namen automatisch vorgeschlagen. Sie können dies bei Bedarf auch ändern. Verwenden Sie den Wert für Feature-Flag-ID als Kennung in Ihrem SDK oder API-Code.
   • Flag Typ -Geben Sie den Typ des Feature-Flags an. Zu den unterstützten Typen gehören: boolesch, Zeichenfolge und numerisch. Weitere Informationen zum Flagtyp und zu Standardwerten finden Sie unter Feature-Flagtyp auswählen.
   • Standardwert - Geben Sie den Standardwert für den ausgewählten Typ des Feature-Flags an. Weitere Informationen zum Flagtyp und zu Standardwerten finden Sie unter Feature-Flagtyp auswählen.
   • Wählen Sie optional eine Sammlung aus, um jetzt ein Feature-Flag anzuwenden. Andernfalls müssen Sie eine Sammlung hinzufügen, bevor Sie ein Feature-Flag umschalten. Sie können das Feature-Flag zu einer oder mehreren Sammlungen hinzufügen, indem Sie in der Liste „ Verfügbarkeit des Flags über Sammlungen hinweg “ die entsprechende Option auswählen.
   • Feature rollout-Geben Sie die Rollout percentage mithilfe des Schiebereglers an. Weitere Informationen zum manuellen Rollout finden Sie unter Konfigurieren des Prozentsatzes für das Feature-Rollout.
   • Beschreibung - Fügen Sie eine Beschreibung des Feature-Flags hinzu (optional).
   • Optional können Sie Tags definieren, die Ihnen helfen, das Feature-Flag zu identifizieren.

5. Klicken Sie auf Erstellen.

Standardmäßig ist der Schalter „Aktiviert“ beim Erstellen eines neuen Feature-Flags auf „ OFF “ gesetzt.

Typ des Feature-Flags auswählen

Sie können einen der folgenden Flagtypen wählen, der einem Feature-Flag zugeordnet ist:

• Boolescher Wert
• Zeichenfolge
• Numerisch

Jeder Flag-Typ hat einen Standardwert.

• Wenn Sie den Kippschalter auf „ON“ stellen, muss der Wert für „Enabled“ angegeben werden; dieser kann jedoch bei der Ausrichtung auf ein Segment überschrieben werden.
• Wenn Sie den Kippschalter auf „OFF“ stellen, muss der Wert für „Disabled“ angegeben werden; dieser kann jedoch bei der Ausrichtung auf ein Segment überschrieben werden.

Zeichenfolge

Wenn Sie den Flag-Typ als Zeichenfolgeauswählen, werden die Details für Standardwert angezeigt:

1. Wählen Sie das Format des Zeichenfolgemarkierungstyps aus der Liste aus. Unterstützte Formate sind Text, JSON und YAML. Wenn das JSON-oder YAML-Format ausgewählt ist, geben Sie den Wert Aktiviert und den Wert Inaktiviert im ausgewählten Format an.

2. Geben Sie Aktivierter Wert an. Dieser Wert wird standardmäßig zurückgegeben, wenn der Umschalter für das Feature-Flag auf „ON“ gesetzt ist. Dieser Wert kann bei der Ausrichtung auf ein Segment überschrieben werden.

3. Geben Sie Inaktivierter Wert an. Dieser Wert wird standardmäßig zurückgegeben, wenn für das Feature-Flag der Schalter auf OFF gesetzt ist.

Numerisch

Wenn Sie den Flag-Typ als Numerischauswählen, werden die Details für Standardwert angezeigt:

1. Wählen Sie aus der Liste Aktivierter Wert aus. Es werden nur ganzzahlige Werte unterstützt. Dieser Wert wird standardmäßig zurückgegeben, wenn der Umschalter für das Feature-Flag auf „ON“ gesetzt ist. Dieser Wert kann bei der Ausrichtung auf ein Segment überschrieben werden.

2. Wählen Sie aus der Liste Inaktivierter Wert aus. Es werden nur ganzzahlige Werte unterstützt. Dieser Wert wird standardmäßig zurückgegeben, wenn für das Feature-Flag der Schalter auf OFF gesetzt ist.

Sammlungen als Ziel für Feature-Flags festlegen

Wählen Sie optional eine Sammlung aus, um jetzt ein Feature-Flag anzuwenden. Andernfalls müssen Sie eine Sammlung hinzufügen, bevor Sie ein Feature-Flag umschalten. Sie können Feature-Flags zu einer oder mehreren Objektgruppen hinzufügen, entweder während der Erstellung des Feature-Flags oder während der Bearbeitung von Feature-Flag-Details.

Um dem Feature-Flag Sammlungen hinzuzufügen, wählen Sie für das Feld Flag-Verfügbarkeit in allen Sammlungen die Sammlung aus der Liste aus.

Wenn Sie versuchen, ein Feature-Flag anzusprechen, das nicht mit einer Sammlung verknüpft ist, wird ein Fenster angezeigt, in dem Sie das Feature-Flag einer Sammlung hinzufügen können.

Prozentsatz für Feature-Rollout konfigurieren

Sie können das Feature-Flag mit einem Rollout-Prozentsatz im Bereich zwischen 0 und 100 konfigurieren. Dieser Wert gibt an, auf welche Teilmenge von Benutzern oder Geräten das Feature anwendbar sein soll.

Eine manuelle Einführung ermöglicht es, eine Funktion zunächst für einen kleinen Prozentsatz zufällig ausgewählter Nutzer oder eine Untergruppe von Entitäten freizuschalten, wodurch eine bessere Kontrolle über den Release-Zyklus gewährleistet wird und eine schrittweise Bereitstellung erreicht wird. Wenn Sie sicher sind, dass die Funktion, die Sie implementieren möchten, wie beabsichtigt funktioniert, erhöhen Sie den Prozentsatz im Laufe der Zeit.

Beim manuellen Rollout wird ein Hash-Algorithmus verwendet, der auf der Grundlage des Regelsatzes einen Hash-Wert erzeugt. Dieser Hashwert wird vom SDK verwendet, um einen Prozentwert für diesen Benutzer zu generieren. Der für diesen Benutzer generierte Prozentwert wird mit dem für die manuelle Einführung festgelegten Wert verglichen, um festzustellen, ob der Benutzer für diese Funktion in Frage kommt oder nicht.

Beispiel: Der Hashwert hat Partitionen von 1 bis 100.000. Wenn Sie ein Feature-Flag zuweisen, ordnet der Hashwert den Benutzern in jeder Partition Werte von 1 bis 100.000 zu. Wenn Sie beispielsweise einem Feature-Flag 25% zuweisen, stellt das App Configuration SDK dieses Feature für Hashpartitionen von 1 bis 25.000 bereit. Wenn Sie den Prozentsatz der Benutzer, die dieses Feature erhalten, von 25% auf 50% ändern, werden die Partitionen 25.001 bis 50.000 zur Gruppe der Partitionen hinzugefügt, die dieses Feature bereits empfangen.

Die Möglichkeit zur manuellen Einführung steht in den Tarifen „Lite“ und „Enterprise“ zur Verfügung.

Nachfolgend sind einige der manuellen Rollout-Szenarien aufgeführt:

• Wenn das Feature-Flag inaktiviert ist, gibt das SDK den Standardwert Inaktiviert zurück.
• Wenn das Feature-Flag ohne Segmentregeln aktiviert ist und kein manuelles Rollout eingestellt ist, gibt das SDK den Standardwert Aktiviert zurück.
• Wenn das Feature-Flag ohne Segmentregel aktiviert ist und das manuelle Rollout auf 0% gesetzt ist, gibt das SDK den Wert Deaktiviert für alle Benutzer zurück.
• Wenn das Feature-Flag ohne Segmentregel aktiviert ist und der manuelle Rollout auf einen Prozentsatz, z. B. 50 %, eingestellt ist, prüft das SDK, ob der Benutzer zu der konfigurierten manuellen Rollout-Größe gehört; wenn der Benutzer zu den Rollout-Kriterien gehört, gibt das SDK den Wert Aktiviert zurück. Wenn der Benutzer nicht zu den Rollout-Kriterien gehört, gibt das SDK den Inaktivierten Wert zurück.
• Wenn das Feature-Flag mit Segmentregeln aktiviert ist, wertet das SDK zuerst den Benutzer anhand der konfigurierten Regeln aus. Wenn der Benutzer Teil der konfigurierten Regel ist, prüft das SDK, ob der Benutzer für ein manuelles Rollout in Frage kommt.
  • Wenn mehrere Regeln konfiguriert sind und der Benutzer bis zur ersten Übereinstimmung auf Regelübereinstimmung überprüft wird. Wenn keine Übereinstimmung gefunden wird, wird das SDK anhand des Standard-Rollouts ausgewertet.
  • Wenn der Benutzer als Teil des Segments gewertet wird und der manuelle Rollout des Segments 0 % beträgt, erhält der Benutzer, selbst wenn er Teil des Segments ist, den Segmentwert nicht. Das SDK gibt den Standardwert Disabled value zurück.
  • Wenn der Benutzer als Teil des Segments ausgewertet wird und der manuelle Rollout des Segments auf einen Prozentsatz, z. B. 50 %, eingestellt ist, prüft das SDK, ob der Benutzer zur konfigurierten Rollout-Größe gehört. Wenn der Benutzer nicht zu den Rollout-Kriterien gehört, gibt das SDK den Wert Inaktiviert zurück.

Segment als Ziel für ein Feature-Flag festlegen

Sie können Feature-Flags für ein oder mehrere Zielsegmente implementieren. Sie können bei Bedarf verschiedene Flag-Werte für verschiedene Segmente festlegen.

1. Rufen Sie in der App Configuration-Konsole die Option Feature-Flags auf. In diesem Bereich wird die Liste der Feature-Flags angezeigt, die in der aktuellen Umgebung der Instanz des „ App Configuration “-Dienstes verfügbar sind.

2. Klicken Sie in der Zeile mit der gewünschten Merkmalskennzeichnung auf Zielgruppen hinzufügen, um das Seitenfenster Zielgruppenkonfigurationen hinzufügen anzuzeigen.

3. Der Abschnitt Feature-Rollout (Standard) zeigt den Standard-Rollout-Prozentsatz-Schieberegler an, der bei der Erstellung des Feature-Flags definiert wurde. Sie können den prozentualen Wert des Rollouts durch Verschieben des Schiebereglers anpassen. Die Änderungen werden automatisch gespeichert, wenn Sie den Schieberegler anpassen.

4. Im Bereich Regeln können Sie Regeln definieren, die bestimmen, wer Ihr Feature sehen kann, und mehrere Regeln einfach verwalten. Die Ausgangsansicht zeigt die Schaltfläche Regel erstellen und ein Suchfeld zum Filtern vorhandener Regeln.

   

   Geben Sie bei der Erstellung der Regel Folgendes an:

   • Regelname- Geben Sie einen beschreibenden Namen für die Regel ein (maximal 100 Zeichen).

   • Regel-ID- Geben Sie einen eindeutigen Bezeichner für die Regel ein. Dieser darf nur Buchstaben, Zahlen, Punkte (.), Bindestriche (-) und Unterstriche (_) enthalten. Maximal 100 Zeichen.

   • Im Rollout-Prozentsatz können Sie den Wert als " Überschreiben" oder "Vererben vom Standard" definieren. Wenn die Option Überschreiben ausgewählt ist, passen Sie den Rollout-Prozentwert mit dem Schieberegler an. Der Prozentsatz wird automatisch gespeichert, wenn Sie den Schieberegler einstellen.

   • Segmente auswählen- Wählen Sie ein oder mehrere Segmente aus der Liste aus. Die ausgewählten Segmente werden mit einer Zählanzeige dargestellt (z. B. "1 × Segment ist ausgewählt"). Wenn für das Ziel keine Segmente verfügbar sind, klicken Sie auf Segment erstellen. Weitere Informationen zum Erstellen eines Segments finden Sie unter Segment erstellen.

   • Für Aktiviert können Sie Überschreiben auswählen und den Wert ändern oder Von Markierung übernehmen auswählen.

   • Priorität- Legen Sie die Regelpriorität fest, um die Reihenfolge zu bestimmen, in der die Regeln ausgewertet werden. Sie können die Priorität auf eine der folgenden Optionen einstellen:

     • Nach unten setzen - Setzt die Priorität der Regel an die letzte Stelle. Dies ist die Standardoption.
     • Nach oben setzen - Setzt die Priorität an den Anfang der Regeln (d.h. 1).
     • Bestimmte Position - Legt die Priorität auf eine bestimmte benutzerdefinierte Position fest. (Die Prioritätsnummer kann zwischen 1 und der Anzahl der Regeln liegen).

   Die Regel wird erstellt und gespeichert, wenn Sie auf Regel speichern klicken. Es gibt keine separate Schaltfläche " Erstellen" oder " Abbrechen" - schließen Sie das Panel einfach, wenn Sie mit der Konfiguration der Regel fertig sind.

5. Nachdem Sie eine Regel erstellt haben, wird sie in der Regeltabelle mit Priorität, Regelname, Segmenten und Rollout-Informationen angezeigt. Sie können die folgenden Aktionen für jede Regel mit Hilfe des Überlaufmenüs durchführen:

   • Kopieren- Erstellen Sie eine neue Regel durch Duplizieren einer bestehenden Regel.

   

   

   • Regel bearbeiten- Ändert eine bestehende Regelkonfiguration.

   ![Menü "Regelüberlauf" bearbeiten](images/ac-edit-rule-overflow-menu.png "Menü "Regelüberlauf" bearbeiten")

   

   • Priorität bearbeiten- Ändern Sie die Reihenfolge der Regelauswertung. Die Priorität bestimmt die Reihenfolge, in der die Regeln ausgewertet werden. Regeln mit einer niedrigeren Prioritätsnummer werden zuerst ausgewertet. Sie können die Priorität auf eine der oben genannten Optionen einstellen.

   ![Menü "Prioritätsüberlauf" bearbeiten](images/ac-edit-priority-overflow-menu.png "Menü "Prioritätsüberlauf" bearbeiten")

   

   • Löschen- Entfernt die Regel. Wenn Sie Löschen wählen, erscheint ein Bestätigungsdialog, um ein versehentliches Löschen zu verhindern.

   ![Menü "Regelüberlauf löschen"](images/ac-delete-rule-overflow-menu.png "Menü "Regelüberlauf löschen"")

   

Wenn Sie versuchen, ein Feature-Flag anzusprechen, das nicht mit einer Sammlung verknüpft ist, wird ein Fenster angezeigt, in dem Sie das Feature-Flag einer Sammlung hinzufügen können.

Wie die Zielgruppenregeln bewertet werden

Beachten Sie bei der Konfiguration des Targetings das folgende Auswertungsverhalten:

• Innerhalb eines Segments werden verschiedene Attribute mit AND bewertet.
• Innerhalb eines einzelnen Segmentattributs werden mehrere Werte mit OR ausgewertet.
• Innerhalb einer Targeting-Regel werden mehrere ausgewählte Segmente mit OR ausgewertet.
• Die Regeln werden nach Priorität bewertet, und die erste passende Regel wird angewendet.

Wenn eine Regel beispielsweise die Segmente Production - US-East und Production - Eu-De enthält, trifft die Regel zu, wenn eines der beiden Segmente zutrifft. Wenn Sie diese Zielgruppen separat ansprechen möchten, erstellen Sie separate Regeln oder definieren Sie jedes Segment mit allen erforderlichen Attributen und ordnen Sie die Regeln nach Priorität.

Wenn Sie eine Funktion zuerst für Produktionsbenutzer in eu-de und später für Produktionsbenutzer in us-east aktivieren möchten, definieren Sie jedes Segment mit allen erforderlichen Attributen, wie z. B:

• Segment 1: environment is production und region is eu-de
• Segment 2: environment is production und region is us-east

Richten Sie diese Segmente dann in separaten Regeln aus und ordnen Sie die Regeln in der Ansicht " Ziele bearbeiten" nach Priorität. Auf diese Weise wird sichergestellt, dass jede Regel nur auf die gewünschte Zielgruppe zutrifft.

Feature-Flag aktivieren

Nachdem Sie ein Feature-Flag einem Segment zugewiesen haben, klicken Sie auf den Schalter (EIN/AUS), um das Feature-Flag zu aktivieren oder zu deaktivieren.

Feature-Flags - Überlaufmenü

Das Überlaufmenü für jedes Feature-Flag (drei vertikale Punkte) besteht aus Bearbeiten-, Kopieren-und Löschen -Operationen und Targeting entfernen für diese Feature-Flags, die bereits ausgewählt sind.

• Wenn die Option „Bearbeiten“ ausgewählt ist, können Sie den Namen und die Beschreibung ändern, Tags hinzufügen oder löschen, den Flaggentyp und den Standardwert ändern sowie Sammlungen für das Feld „ Verfügbarkeit des Flags über Sammlungen hinweg “ hinzufügen oder entfernen.
• Wenn die Option „Kopieren“ ausgewählt ist, werden die Informationen zum Feature-Flag kopiert, und Sie müssen den Namen des Feature-Flags ändern. Ändern Sie optional die anderen Details je nach Ihrem Bedarf.
• Wenn die Option Löschen ausgewählt ist, wird ein Bestätigungsfenster für das Löschen des ausgewählten Feature-Flags angezeigt. Durch die Option „Löschen“ wird das Feature-Flag endgültig gelöscht, und der Vorgang kann nicht rückgängig gemacht werden.
• Wenn Sie in der Liste der Feature-Flags in einem Feature-Flag klicken, wenn auf das Symbol In Zwischenablage kopieren geklickt wird, wird der Wert für Feature-Flag-ID des Feature-Flags in die Zwischenablage kopiert.
• Durch das Entfernen der Zielausrichtung wird die Zuordnung von Feature-Flags zu einem Segment aufgehoben.