Remote Config-Vorlagen sind Gruppen von JSON-formatierten Parametern und Bedingungen, die Sie für Ihr Firebase-Projekt erstellt haben. Sie können Client-Vorlagen erstellen, aus denen Ihre App Werte abruft, und Server-Vorlagen, aus denen Server-Clients Werte abrufen können.
In diesem Abschnitt werden Servervorlagen behandelt. Wenn Sie mehr über clientspezifische Vorlagen erfahren möchten, klicken Sie auf Clientvorlagen.Sie können die Firebase-Konsole verwenden, um die Vorlage zu ändern und zu verwalten. Rufen Sie DevOps & Engagement > Remote Config auf, um den Inhalt der Vorlage im grafischen Format auf der Seite Parameter und auf der Seite Bedingungen anzusehen.
Hier sehen Sie ein Beispiel für eine Servervorlagendatei:
{
"parameters": {
"preamble_prompt": {
"defaultValue": {
"value": "You are a helpful assistant who knows everything there is to know about Firebase! "
},
"description": "Add this prompt to the user's prompt",
"valueType": "STRING"
},
"model_name": {
"defaultValue": {
"value": "gemini-pro-test"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
},
"valueType": "JSON"
},
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
Sie können diese Aufgaben zur Versionsverwaltung in der Firebase-Konsole ausführen (rufen Sie DevOps & Engagement > Remote Config auf):
- Alle gespeicherten Vorlagenversionen auflisten
- Bestimmte Version abrufen
- Rollback auf eine bestimmte Clientversion durchführen
- Remote Config-Vorlagen auf der Seite Änderungsverlauf löschen.
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.
Jedes Mal, wenn Sie Parameter aktualisieren, erstellt Remote Config eine neue versionierte Remote Config-Vorlage und speichert die vorherige Vorlage als Version, die Sie bei Bedarf abrufen oder auf die Sie ein Rollback durchführen können. Versionsnummern werden sequenziell ab dem von Remote Config gespeicherten Anfangswert erhöht.
Alle Vorlagen enthalten ein version-Feld, wie unten dargestellt, das Metadaten zu dieser spezifischen Version enthält.
Sie können Remote Config-Vorlagen bei Bedarf in der DevOps & Engagement-Konsole > Remote Config > > Änderungsverlauf > > Firebase löschen.
Remote Config-Vorlagenversionen verwalten
In diesem Abschnitt wird beschrieben, wie Sie Versionen Ihrer Remote Config-Vorlage verwalten.
Alle gespeicherten Versionen der Vorlage Remote Config auflisten
Sie können eine Liste aller gespeicherten Versionen der Vorlage Remote Config abrufen. Dazu
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Parameter auf.
Wählen Sie oben rechts das Uhrensymbol aus.
Dadurch wird die Seite Änderungsverlauf geöffnet. Dort werden alle gespeicherten Vorlagenversionen in einem Listenmenü auf der rechten Seite aufgeführt.
Die Liste der Vorlagen enthält Metadaten für alle gespeicherten Versionen, einschließlich des Zeitpunkts der Aktualisierung, des Nutzers, der sie vorgenommen hat, und der Art der Aktualisierung.
Eine bestimmte Version der Vorlage Remote Config abrufen
Sie können jede gespeicherte Version der Vorlage Remote Config abrufen. So rufen Sie eine gespeicherte Vorlagenversion ab:
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Änderungsverlauf auf.
Standardmäßig wird auf der Seite die aktuell aktive Vorlage angezeigt. Wenn Sie eine andere Version aufrufen möchten, wählen Sie sie im Detailbereich auf der rechten Seite aus.
Wenn Sie einen detaillierten Vergleich der aktiven Vorlage mit einer anderen gespeicherten Version aufrufen möchten, bewegen Sie den Mauszeiger auf das Kontextmenü einer nicht ausgewählten Version und wählen Sie Mit ausgewählter Version vergleichen aus.
Rollback zu einer bestimmten gespeicherten Version der Vorlage Remote Config durchführen
Sie können ein Rollback zu jeder gespeicherten Version der Vorlage durchführen. So machen Sie eine Vorlage rückgängig:
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Änderungsverlauf auf.
Suchen Sie rechts oben auf der Seite nach der Optionsschaltfläche für frühere Vorlagenversionen, die für ein Rollback infrage kommen.
Klicken Sie nur dann auf „Bestätigen“, wenn Sie sicher sind, dass Sie ein Rollback auf diese Version durchführen und diese Werte sofort für alle Apps und Nutzer verwenden möchten.
Durch diesen Rollback-Vorgang wird effektiv eine neue nummerierte Version erstellt. Wenn Sie beispielsweise von Version 10 auf Version 6 zurücksetzen, wird effektiv eine neue Kopie von Version 6 erstellt, die sich vom Original nur durch die Versionsnummer 11 unterscheidet. Die ursprüngliche Version 6 wird weiterhin gespeichert, sofern sie noch nicht abgelaufen ist, und Version 11 wird zur aktiven Vorlage.
Remote Config-Vorlage löschen
Sie können Remote Config-Vorlagen über die Firebase-Konsole löschen. So löschen Sie eine Vorlage:
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Parameter auf.
Klicken Sie auf
Änderungsverlauf .Wählen Sie die Vorlage aus, die Sie löschen möchten, klicken Sie auf
Mehr und dann auf Löschen.Wenn Sie aufgefordert werden, das Löschen zu bestätigen, klicken Sie auf Löschen.
Remote Config-Vorlagen herunterladen und veröffentlichen
Laden Sie Remote Config-Vorlagen herunter und veröffentlichen Sie sie, um sie in Ihre Quellcodeverwaltung und Build-Systeme zu integrieren, Konfigurationsaktualisierungen zu automatisieren und Parameter und Werte in mehreren Projekten zu synchronisieren.
Sie können die derzeit aktive Remote Config-Vorlageüber die Firebase-Konsole herunterladen. Sie können die exportierte JSON-Datei dann aktualisieren und im selben Projekt oder in einem neuen oder vorhandenen Projekt veröffentlichen.
Angenommen, Sie haben mehrere Projekte, die verschiedene Phasen Ihres Softwareentwicklungszyklus darstellen, z. B. Entwicklungs-, Test-, Staging- und Produktionsumgebungen. In diesem Fall können Sie eine vollständig getestete Vorlage aus Ihrer Staging-Umgebung in Ihre Produktionsumgebung übertragen, indem Sie sie aus Ihrem Staging-Projekt herunterladen und in Ihrem Produktionsprojekt veröffentlichen.
Sie können diese Methode auch verwenden, um Konfigurationen von einem Projekt in ein anderes zu migrieren oder ein neues Projekt mit Parametern und Werten aus einem bestehenden Projekt zu füllen.
Parameter und Parameterwerte, die speziell als Varianten in einem A/B Testing-Test erstellt wurden, sind nicht in exportierten Vorlagen enthalten.
So exportieren und importieren Sie Remote Config-Vorlagen:
- Laden Sie die aktuelle Remote Config-Konfigurationsvorlage herunter.
- Validieren Sie die Remote Config-Vorlage.
- Veröffentlichen Sie die Remote Config-Vorlage.
Aktuelle Remote Config-Vorlage herunterladen
Verwenden Sie Folgendes, um die aktive Remote Config-Vorlage im JSON-Format herunterzuladen:
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Parameter oder Bedingungen auf.
Öffnen Sie das
Menü und wählen Sie Aktuelle Konfigurationsdatei herunterladen aus.Klicken Sie bei Aufforderung auf Konfigurationsdatei herunterladen, wählen Sie den Speicherort aus, an dem Sie die Datei speichern möchten, und klicken Sie dann auf Speichern.
Remote Config-Vorlage validieren
Servervorlagen werden validiert, wenn Sie versuchen, über die Firebase-Konsole zu veröffentlichen. Bedingungen vom Typ „Nutzer in zufälligem Prozentwert“ können importiert werden. Bei nicht unterstützten Bedingungen wird jedoch beim Hochladen ein Fehler ausgegeben. Wenn Sie versuchen, eine Vorlage zu veröffentlichen, die ursprünglich aus einer Clientvorlage exportiert wurde, müssen Sie zuerst alle clientspezifischen Bedingungen entfernen.
Vorlage Remote Config veröffentlichen
Nachdem Sie eine Vorlage heruntergeladen, die erforderlichen Änderungen am JSON-Inhalt vorgenommen und sie validiert haben, können Sie sie in einem Projekt veröffentlichen.
Wenn Sie eine Vorlage veröffentlichen, wird die gesamte vorhandene Konfigurationsvorlage durch die aktualisierte Datei ersetzt und die Vorlagenversion um eins erhöht. Da die gesamte Konfiguration ersetzt wird, wird ein Parameter, den Sie aus der JSON-Datei löschen und veröffentlichen, auch vom Server gelöscht und ist für Clients nicht mehr verfügbar.
Nach der Veröffentlichung sind Änderungen an Parametern und Werten sofort für Ihre Apps und Nutzer verfügbar. Bei Bedarf können Sie ein Rollback auf eine frühere Version durchführen.
Verwenden Sie die folgenden Befehle, um Ihre Vorlage zu veröffentlichen:
Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Parameter oder Bedingungen auf.
Öffnen Sie das
Menü und wählen Sie Aus Datei veröffentlichen aus.Klicken Sie bei Aufforderung auf Durchsuchen, rufen Sie die Remote Config-Datei auf, die Sie veröffentlichen möchten, und wählen Sie sie aus. Klicken Sie dann auf Auswählen.
Die Datei wird validiert. Wenn die Validierung erfolgreich ist, können Sie auf Veröffentlichen klicken, um die Konfiguration sofort für Ihre Apps und Nutzer verfügbar zu machen.
Nächste Schritte
- Weitere Informationen zur Verwendung von Remote Config in Serverumgebungen
- Probieren Sie serverseitiges Remote Config mit Cloud Functions und Agent Platform aus.