{"canonical_url":"https://engineer.company/de/glossary/feature-flag/","content_markdown":"# Feature-Flag\n\n## Was es ist\n\nEin Feature-Flag ist eine Entscheidungsstelle im Code, die eine Einstellung\nliest, die das Team ohne erneuten Build der Anwendung ändern kann. Dahinter\nliegt ein neuer Codepfad, der bereits in Produktion ist, aber ruht, bis die\nEinstellung ihn einschaltet, für alle oder für eine ausgewählte Nutzergruppe.\nPete Hodgson beschrieb die Technik ausführlich auf Martin Fowlers Website, in\nmehreren Teilen ab Januar 2016 und mit einer Überarbeitung im Oktober 2017.\nEr nennt sie Feature Toggles und führt Feature Flags, Feature Bits und Feature\nFlippers als weitere Bezeichnungen für dasselbe auf.\n\nHodgson zerlegt ein Flag in Bestandteile. Der Toggle Point ist die Stelle im\nCode, die fragt, ob der neue Pfad eingeschaltet ist. Der Toggle Router beantwortet\ndie Frage anhand der Toggle-Konfiguration und, wenn die Antwort vom Fragenden\nabhängt, anhand eines Toggle-Kontexts: meist des aktuellen Nutzers oder eines\nspeziellen Cookies oder HTTP-Headers, der stellvertretend für ihn steht.\nHodgson warnt davor, beide zu koppeln. Der Code am Toggle Point sollte eine eng\ngefasste Frage stellen, etwa ob diese Bestellbestätigung den neuen\nStornierungslink enthält. Die entscheidende Regel liegt dagegen zentral hinter\ndem Router, damit sie sich ändern lässt, ohne jede Aufrufstelle anzufassen.\n\nFlags unterscheiden sich nach Lebensdauer und Häufigkeit wechselnder Antworten.\nHodgson ordnet sie vier Arten zu. Release Toggles lassen unfertigen, ungetesteten\nCode als ruhenden Code in Produktion gelangen. Sie sollten nach seinen Worten\n„im Allgemeinen nicht viel länger als ein oder zwei Wochen bestehen bleiben“.\nExperiment Toggles teilen Nutzer für einen A/B-Test in Gruppen ein; jeder\nNutzer landet jedes Mal in derselben Gruppe. Ops Toggles ermöglichen dem Betriebspersonal, das Verhalten des produktiven\nSystems zu ändern. Viele sind kurzlebig, doch einige\nlanglebige Notausschalter ermöglichen bei ungewöhnlich hoher Last, verzichtbare\nFunktionalität zurückzufahren, etwa ein teuer zu erzeugendes Empfehlungsfeld.\nHodgson vergleicht sie mit einem manuell verwalteten Circuit Breaker.\nPermissioning Toggles entscheiden, welche Funktionen ein bestimmter Nutzer\nsieht, etwa Premium-Funktionen für zahlende Kunden oder Alpha-Funktionen für\neigene Beschäftigte. Sie können jahrelang bestehen bleiben.\n\nEin Feature-Flag ist kein Canary Release, auch wenn beide oft zusammenwirken.\nEin Canary betreibt zwei Versionen eines Dienstes nebeneinander und leitet einen\nTeil des Verkehrs zur neuen. Ein Flag liefert eine Version mit beiden Pfaden\nund wählt bei jeder Anfrage zwischen ihnen. Auch ein langlebiger Branch in der\nVersionsverwaltung hält neue Arbeit getrennt. Der Code gelangt dann aber erst\nbeim Zusammenführen des Branches in Produktion, und zwar auf einmal.\n\n## Warum es wichtig ist\n\nDer Hauptgrund für Flags ist die Trennung von Bereitstellung und Freigabe.\nHodgson beschreibt Release Toggles als häufigste Umsetzung eines Prinzips von\nContinuous Delivery: Die Freigabe einer Funktion ist ein eigener Schritt,\ngetrennt von der Bereitstellung ihres Codes. Code kann täglich aus einem\neinzigen Hauptbranch in Produktion gelangen, während eine Funktion, deren\nEntwicklung einen Monat dauert, ausgeschaltet bleibt, bis sie fertig ist. Das macht\nTrunk-Based Development praktikabel.\n\nWeil ein Flag verschiedenen Nutzern verschiedene Antworten geben kann, lässt\nsich eine Freigabe schrittweise ausweiten. Hodgson beschreibt, neue Funktionen\nzuerst für interne Nutzer einzuschalten. Das nennt er Champagne Brunch, weil\ndas Unternehmen zuerst seinen eigenen Champagner trinken darf. Danach folgt\neine Canary-Kohorte: In seinem Beispiel wird eine zufällige Gruppe von 1 Prozent\nder Nutzer durch eine Modulo-Operation auf der Nutzer-ID ausgewählt, damit\ndieselben Personen in der Gruppe bleiben. Die übrigen 99 Prozent behalten das alte\nVerhalten. Meldet die Kohorte Probleme, wird das Flag ausgeschaltet, ohne dass\njemand eine Bereitstellung zurückrollen muss.\n\nDas alles hat seinen Preis. Jedes Flag ergänzt eine Verzweigung im Code und\neine zu testende Kombination. Die dahinterliegende Konfiguration wird zu einem\nTeil der Produktion, der sich ohne Build ändern kann. Hodgson empfiehlt,\nToggle-Konfigurationen in der Versionsverwaltung zu halten und sie durch erneute\nBereitstellungen zu ändern, wo das Flag dies zulässt. Die Konfiguration\ndurchläuft dann dieselbe Pipeline wie der Code, und ihre Änderungen werden\ngeprüft und aufgezeichnet. Bei Flags, die sich innerhalb von Minuten ändern\nmüssen, etwa Ops Toggles, rechtfertigt sich eine Laufzeitkonfiguration.\n\n## Wie es in der Praxis aussieht\n\nflagd ist eine quelloffene Engine zur Flag-Auswertung nach der\nOpenFeature-Spezifikation. Sie hat keine Benutzeroberfläche und speichert\nselbst nichts. Sie liest Flag-Definitionen aus einer JSON-Datei oder einer\nanderen Quelle und beantwortet Anfragen, entweder als Sidecar, im\nAnwendungsprozess oder als zentraler Dienst. Ein Flag, das etwa jeden\nzwanzigsten Nutzer zu einem neuen Kaufabschluss leitet, sieht so aus:\n\n```json\n{\n  \"$schema\": \"https://flagd.dev/schema/v0/flags.json\",\n  \"flags\": {\n    \"new-checkout\": {\n      \"state\": \"ENABLED\",\n      \"variants\": {\n        \"on\": true,\n        \"off\": false\n      },\n      \"defaultVariant\": \"off\",\n      \"targeting\": {\n        \"fractional\": [\n          [\"on\", 5],\n          [\"off\", 95]\n        ]\n      },\n      \"metadata\": {\n        \"owner\": \"checkout\",\n        \"expires\": \"2027-01-31\"\n      }\n    }\n  }\n}\n```\n\nJedes Flag hat einen Zustand und eine Menge von Varianten, die alle denselben Typ haben müssen; die Standardvariante ist optional. Die Regel `fractional` verteilt Nutzer nach relativen Gewichten\nauf Gruppen. 5 und 95 setzen daher etwa jeden zwanzigsten Nutzer auf `on`.\nStandardmäßig wird die Gruppe aus dem Flag-Schlüssel und dem `targetingKey` im\nAuswertungskontext berechnet. Derselbe Nutzer erhält dadurch immer dieselbe\nAntwort, und das Umbenennen des Flags verteilt alle neu. `metadata` enthält\nbeliebige vom Team angehängte Angaben, hier einen Verantwortlichen und das Datum,\nbis zu dem das Flag entfernt sein sollte. Wird `state` auf `DISABLED` gesetzt,\nantwortet flagd ganz ohne Wert. Der Aufrufer fällt dann auf seinen eigenen\nStandardwert zurück.\n\nflagd mit der Datei starten und über HTTP eine Antwort anfordern:\n\n```sh\nflagd start --uri file:./flags.json\ncurl -X POST \"localhost:8013/flagd.evaluation.v1.Service/ResolveBoolean\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"flagKey\":\"new-checkout\",\"context\":{\"targetingKey\":\"user-4711\"}}'\n```\n\nDie Antwort enthält den Wert, die Variante und den Grund `TARGETING_MATCH`. In\nder Anwendung erfolgt der Aufruf über einen OpenFeature-Client mit dem\nFlag-Schlüssel, dem Standardwert `false` und dem Auswertungskontext. Der Toggle\nPoint sieht nur wahr oder falsch. Den Anteil von 5 auf 20 Prozent zu erhöhen\nbedeutet eine Änderung der Flag-Datei, keine Änderung am Build der Anwendung.\n\nDie\n[Arbeitsbereiche für Personalgewinnung und die Laufbahn von Seeleuten](/de/portfolio/built-the-hiring-and-seafarer-career-workspaces/)\naus der seit 2025 laufenden Tätigkeit zeigen ein Release-Flag im dokumentierten Implementierungsstand:\nDer Bereich für Personalgewinnung wird als live beschrieben, der\nLaufbahnbereich als per Feature-Flag gesteuert und unvollständig freigegeben.\nDas ist eine historische Momentaufnahme, keine Aussage über den heutigen\nBereitstellungsstand. Im\n[Backoffice für den Betrieb](/de/portfolio/built-the-operator-back-office-for-the-platform/)\naus derselben Tätigkeit werden solche Flags geändert. Das Betriebspersonal schaltet\nFlags um und aktiviert Funktionen über eine Oberfläche nur für bestimmte Nutzer,\nstatt dass eine technische Fachkraft die Produktionsdatenbank von Hand ändert.\nJede Änderung wird dort wie jede andere Aktion autorisiert und aufgezeichnet.\n\n## Wo es schiefgeht\n\n**Flags, die nie verschwinden.** Ein Release-Flag, das seinen Zweck erfüllt hat,\nverursacht nur noch Kosten: eine unnötige Verzweigung, einen Pfad, den niemand testet,\nund eine Einstellung, die jemand versehentlich umlegen kann. Hodgson schlägt\nvor, Flags als Bestand zu behandeln, der Kosten verursacht, und ihn klein zu halten.\nZu seinen Gegenmitteln gehören eine Aufgabe zum Entfernen im Backlog, sobald\nein Release-Flag eingeführt wird, ein Ablaufdatum, eine Zeitbombe, die nach\nAblauf einen Test scheitern lässt oder den Anwendungsstart verhindert, und eine\nfeste Höchstzahl von Flags, sodass für ein neues ein anderes entfernt werden\nmuss. Ein Flag zu entfernen heißt, neben der Prüfung auch den verworfenen\nCodepfad zu löschen.\n\n**Ein altes Flag erhält eine neue Bedeutung.** Am 1. August 2012 schickte Knight\nCapitals automatischer Order-Router SMARS innerhalb von 45 Minuten Millionen\nAufträge an den Markt. Das Unternehmen verlor mehr als 460 Millionen US-Dollar.\nDie SEC-Verfügung beschreibt den Ablauf. Neuer Code für das Retail Liquidity\nProgram der New York Stock Exchange verwendete ein auf eingehenden Aufträgen\nmitgeführtes Flag erneut. Es hatte früher Power Peg eingeschaltet, eine seit\n2003 nicht mehr genutzte, aber nie entfernte Funktion. Bei der Bereitstellung\nwurde einer von acht Servern ausgelassen. Dort weckte das wiederverwendete Flag\ndie alte Funktion. Als Beschäftigte den neuen Code anschließend von den anderen\nsieben entfernten, aktivierte das Flag auch dort Power Peg. Geben Sie einem\nausgemusterten Flag nie eine neue Bedeutung, löschen Sie toten Code zusammen\nmit seinem Schutz-Flag und prüfen Sie vor dem Einschalten, ob alle Server\ndenselben Build ausführen.\n\n**Kombinationen, die niemand getestet hat.** Zwei Flags ergeben vier\nKombinationen, zehn ergeben über tausend. Hodgson nennt das eine kombinatorische\nExplosion. Alle zu testen ist selten möglich. Testen Sie daher die Kombinationen,\ndie in Produktion gelangen können: die aktuelle Produktionskonfiguration mit\neingeschalteten, kurz vor der Freigabe stehenden Flags, den Rückfallzustand mit\ndiesen Flags ausgeschaltet und, wie viele Teams zusätzlich, alles eingeschaltet.\nEine feste Konvention hilft: „Aus“ bedeutet immer das bestehende Verhalten,\n„Ein“ das neue.\n\n**Ein Standardwert, den niemand gewählt hat.** Laut OpenFeature-Spezifikation\ndarf die Flag-Auswertung keine Ausnahme auslösen. Geht etwas schief, gibt der\nAufruf den vom Aufrufer übergebenen Standardwert zurück. Die ausführliche\nErgebnisform enthält einen Fehlercode. Auch der Client sollte nichts ins Log\nschreiben, weil eine vor der Definition ihres Flags bereitgestellte Anwendung\ndas Log sonst mit `FLAG_NOT_FOUND` fluten würde. Das hält die Anwendung am\nLaufen, bedeutet aber auch, dass ein Tippfehler im Flag-Schlüssel unbemerkt für\nalle Nutzer den Standardwert ergibt. Übergeben Sie das alte, sichere Verhalten\nals Standard und hängen Sie einen Hook an, an dem die Spezifikation das Logging\nvorsieht. Zählen Sie damit Auswertungen, die mit einem Fehler enden, und lösen\nSie bei deren Auftreten einen Alarm aus.\n\n**Überschreibungen, die jeder setzen kann.** Tester können ein Flag bequem mit\neinem speziellen Cookie, einem URL-Parameter oder einem HTTP-Header einschalten.\nHodgson weist darauf hin, dass neugierige oder böswillige Nutzer dieselbe\nÜberschreibung setzen und damit den Zustand eines Flags für sich ändern können.\nBerücksichtigen Sie solche Überschreibungen nur bei internem Verkehr oder\nsignieren Sie sie kryptografisch. Das entschärft die Sorge, erhöht aber, wie\nHodgson anmerkt, selbst Komplexität und Angriffsfläche.\n\n## Weiterführende Lektüre\n\n- [Feature Toggles (auch Feature Flags)](https://martinfowler.com/articles/feature-toggles.html)\n  — Pete Hodgsons Artikel auf Martin Fowlers Website: Bestandteile eines\n  Toggles, die vier Kategorien, Tests und das Kleinhalten des Bestands.\n- [API zur Flag-Auswertung](https://openfeature.dev/specification/sections/flag-evaluation/)\n  — die OpenFeature-Spezifikation zum Auswerten von Flags, einschließlich\n  Standardwerten, Fehlercodes und dem Grund, warum die Auswertung keine\n  Ausnahmen auslöst.\n- [flagd: Flag-Definitionen](https://flagd.dev/reference/flag-definitions/) — das\n  von flagd gelesene JSON-Format: Zustand, Varianten, Standardvariante,\n  Zielgruppenauswahl und Metadaten.\n- [flagd: Fractional-Operation](https://flagd.dev/reference/custom-operations/fractional-operation/)\n  — deterministische prozentuale Aufteilungen und die Auswahl der Gruppe eines\n  Nutzers.\n- [In der Sache Knight Capital Americas LLC](https://www.sec.gov/files/litigation/admin/2013/34-70694.pdf)\n  — die SEC-Verfügung von 2013 zum Handelsverlust im August 2012, einschließlich\n  des wiederverwendeten Flags.\n\n\u003chttps://engineer.company/de/glossary/feature-flag/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Ein Laufzeitschalter trennt Bereitstellung und Freigabe von Code: Arten von Feature-Flags, ihre Auswertung und die technischen Schulden, die sie hinterlassen.","formats":{"gemtext":"https://engineer.company/de/glossary/feature-flag/index.gmi","gopher":"https://engineer.company/de/glossary/feature-flag/gophermap","html":"https://engineer.company/de/glossary/feature-flag/","json":"https://engineer.company/de/glossary/feature-flag/index.json","markdown":"https://engineer.company/de/glossary/feature-flag/index.md","pdf":"https://engineer.company/de/glossary/feature-flag/index.pdf"},"kind":"page","language":"de","title":"Was ist ein Feature-Flag?","url":"https://engineer.company/de/glossary/feature-flag/","version":1}