Remote Config-Vorlagen und Versionsverwaltung

Remote Config-Vorlagen sind Gruppen von Parametern und Bedingungen im JSON-Format, die für Ihr Firebase-Projekt erstellt wurden. Remote Config organisiert Konfigurationen in Vorlagen, die erstellt, aktualisiert, versioniert und zurückgesetzt werden können.

Je nach Architektur können Sie Clientvorlagen, Servervorlagen oder beides erstellen und verwalten:

  • Clientvorlagen: Konfigurationen für Client-App-Instanzen auf Apple-, Android-, Web-, Flutter-, Unity- und C++-Plattformen bereitstellen. Clientvorlagen unterstützen Bedingungen, die auf Google Analytics-Zielgruppen, App-Versionen, Plattform, Gerätesprache, Land, Nutzerprozentilen und benutzerdefinierten Signalen basieren.

  • Servervorlagen: Konfigurationen für Backend-Umgebungen wie Cloud Run, Cloud Functions for Firebase oder containerisierte Server mit dem Firebase Admin SDK für Node.js, Python, Go und Java bereitstellen. Servervorlagen werten Parameter serverseitig mit nahezu null Latenz aus. Dabei werden benutzerdefinierte Serversignale und zufällige prozentuale Rollouts verwendet.

Client- und Servervorlagen vergleichen

Client- und Servervorlagen werden unabhängig voneinander in Ihrem Firebase-Projekt verwaltet. In der folgenden Tabelle sehen Sie, wie sich Client- und Servervorlagen unterscheiden:

Funktion Clientvorlagen Servervorlagen
Zielumgebungen Client-Apps (Apple, Android, Web, Flutter, Unity, C++) Serverumgebungen (Cloud Run, Cloud Functions for Firebase, GKE, Backend-Dienste)
Unterstützte SDKs Firebase-Client-SDKs Firebase Admin SDK (Node.js, Python, Go, Java)
Managementtools Firebase Console, Firebase CLI, REST API, Firebase Admin SDK Firebase-Konsole
Konsolenstandort Parameter und Bedingungen Parameter und Bedingungen
Standardeinstellungen für Vorlagen herunterladen Unterstützt (XML für Android, PLIST für iOS, JSON für Web) Nicht zutreffend (Standardwerte im Servercode oder Backend definiert)
Detaillierte Anleitung Clientvorlagen verwalten Servervorlagen verwalten

Lebenszyklus und Versionsverwaltung von Vorlagen

Unabhängig davon, ob Sie mit Client- oder Servervorlagen arbeiten, bietet Remote Config eine integrierte Versionsverwaltung und ein integriertes Lebenszyklusmanagement:

Versionen erstellen und nachverfolgen

Jedes Mal, wenn Sie Parameter oder Bedingungen aktualisieren, erstellt Remote Config eine neue versionierte Remote Config-Vorlage und speichert die vorherige Vorlage als Version, die Sie bei Bedarf abrufen oder ein Rollback durchführen können. Versionsnummern werden sequenziell ab dem von Remote Config gespeicherten Anfangswert erhöht.

Alle Vorlagen enthalten das Feld version mit Metadaten zur jeweiligen Version, z. B.:

  • versionNumber: Die fortlaufende Versionsnummer der Vorlage.
  • updateTime: Der Zeitstempel, der angibt, wann die Vorlage veröffentlicht wurde.
  • updateUser: Die E-Mail-Adresse oder Identität des Nutzers, der die Aktualisierung vorgenommen hat.
  • updateOrigin: Wie die Änderung vorgenommen wurde, z. B. CONSOLE, REST_API oder ADMIN_SDK_NODE.
  • updateType: Die Art der Änderung (z. B. INCREMENTAL_UPDATE oder FORCED_UPDATE).

Versionslimits und ‑aufbewahrung

Es gibt ein Gesamtlaufzeitlimit von 300 gespeicherten Versionen pro Vorlagentyp (300 Clientvorlagen und 300 Servervorlagen). Das Limit umfasst auch gespeicherte Versionsnummern für gelöschte Vorlagen. Wenn Sie im Laufe eines Projekts mehr als 300 Vorlagenversionen pro Vorlagentyp veröffentlichen, werden die ältesten Versionen gelöscht, sodass maximal 300 Versionen dieses Typs vorhanden sind.

Rollbacks

Sie können jederzeit zu einer beliebigen gespeicherten Version einer Vorlage zurückkehren. Wenn Sie ein Rollback durchführen, erstellt Remote Config eine neue Version, deren Inhalt mit der ausgewählten historischen Version übereinstimmt. Wenn Sie beispielsweise von Version 10 auf Version 6 zurücksetzen, wird Version 11 mit der Konfiguration von Version 6 erstellt.

Import und Export

Sie können Ihre aktive Vorlage als JSON-Datei herunterladen und im selben oder in einem anderen Projekt veröffentlichen. Damit haben Sie folgende Möglichkeiten:

  • Speichern Sie Vorlagendefinitionen in der Quellcodeverwaltung (z. B. Git).
  • Konfigurationsbereitstellungen in CI/CD-Pipelines einbinden.
  • Konfigurationen über verschiedene Phasen hinweg übertragen (z. B. von einem Entwicklungs- oder Staging-Projekt in die Produktion).
  • Konfigurationen zwischen Projekten migrieren

Parameter und Parameterwerte, die speziell als Varianten in einem A/B Testing-Test erstellt wurden, sind nicht in exportierten Vorlagen enthalten.

Standardeinstellungen für Vorlagen

Für Clientanwendungen können Sie Dateien mit Standardwerten für Parameter im XML-, PLIST- oder JSON-Format herunterladen, um sie in Ihre App einzubinden. Eine Anleitung dazu finden Sie unter Remote Config-Vorlagenstandards herunterladen.

Nächste Schritte