Manifeste für Funktions-Flags verwenden

In diesem Leitfaden erfahren Sie, wie Sie Funktions-Flags aus einem App Lifecycle Manager-Manifest für Funktions-Flags erstellen oder exportieren.

Mit App Lifecycle Manager-Feature-Flags können Sie die Verfügbarkeit und das Verhalten von Funktionen in Ihren Anwendungen steuern, ohne dass neue Codebereitstellungen oder Infrastrukturänderungen erforderlich sind. Mit Funktions-Flag-Manifesten können Sie Funktions-Flags in Gruppen erstellen, sodass Sie Funktions-Flags nicht manuell in Ihrer Verwaltungsebene und lokalen Entwicklungsumgebung erstellen und synchronisieren müssen. Manifeste bieten ein Tool für die Bulk-Verwaltung, mit dem Sie Ihre Flags mithilfe von JSON-Dateien verwalten können, die dem OpenFeature-Flag-Manifestschema entsprechen.

Vorbereitung

Prüfen Sie zuerst, ob Sie Folgendes haben:

  1. Eine gcloud-Umgebung, die für die Verwaltung von App Lifecycle Manager-Ressourcen konfiguriert ist.
  2. Sie haben die Kurzanleitung zum Bereitstellen von Funktions-Flags durchgearbeitet.

Flags aus einem Manifest erstellen

Mit dem Befehl push können Sie mehrere Flags gleichzeitig erstellen, indem Sie eine lokale JSON-Manifestdatei angeben.

  1. Erstellen Sie eine Datei mit dem Namen my_flags.json und Ihren Flag-Definitionen. Diese Datei dient als lokale Source of Truth für Ihr Manifest.

    Beispiel my_flags.json:

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. Führen Sie den Befehl push aus und geben Sie Ihre Manifestdatei und das Ziel-UnitKind an.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

Manifest aus vorhandenen Flag-Konfigurationen erstellen

Mit dem Befehl pull werden vorhandene Flag-Konfigurationen aus der App Lifecycle Manager API abgerufen und eine lokale JSON-Manifestdatei generiert. So können Sie eine lokale Aufzeichnung Ihrer Flags führen oder sie für die Verwendung mit OpenFeature-Codegenerierungstools vorbereiten.

  1. Führen Sie den Befehl pull aus und geben Sie den gewünschten Ausgabepfad an.

     gcloud beta app-lifecycle-manager flags pull \
     --output-file="manifest.json" \
     --unit-kind="UNIT_KIND_NAME" \
     --overwrite-output-file

  2. Wenn Sie typsichere Flag-Accessoren verwenden, führen Sie das OpenFeature CLI-Codegenerierungstool für die neue manifest.json aus, um die typsicheren Flag-Accessoren Ihrer Anwendung zu aktualisieren. So wird sichergestellt, dass die Manifeste mit den Schlüsseln und Typen auf der Verwaltungsebene übereinstimmen.

Nächste Schritte