| Vorlagentyp auswählen: | Clientvorlagen Servervorlagen |
Remote Config-Vorlagen sind Sätze von JSON-formatierten Parametern und Bedingungen, die für Ihr Firebase-Projekt erstellt wurden. Servervorlagen stellen Konfigurationen für Serverinstanzen über das Firebase Admin SDK für Remote Config bereit (verfügbar für Node.js, Java, Python und Go).
Sie können die Firebase-Konsole verwenden, um Ihre Servervorlage zu ändern und zu verwalten. Gehen Sie zu DevOps & Engagement > Remote Config, um den Inhalt der Vorlage im grafischen Format auf der Seite Parameter und 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-3.8-flash"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"maxOutputTokens\": 2048}"
},
"valueType": "JSON"
}
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
Sie können diese Aufgaben zur Versionsverwaltung in der Firebase-Konsole ausführen (DevOps & Engagement > Remote Config):
- Alle gespeicherten Vorlagenversionen auflisten
- Bestimmte Version abrufen
- Rollback auf eine bestimmte Serverversion durchführen
- Löschen Sie Remote Config Vorlagen auf der Seite Änderungsverlauf.
Es gibt ein Limit von insgesamt 300 gespeicherten Versionen pro Vorlagentyp (300 Clientvorlagen und 300 Servervorlagen). Dazu gehören auch gespeicherte Versionsnummern für gelöschte Vorlagen. Wenn Sie während der Lebensdauer eines Projekts mehr als 300 Vorlagenversionen pro Vorlagentyp veröffentlichen, werden die frühesten Versionen gelöscht, sodass maximal 300 Versionen dieses Typs beibehalten werden.
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 zurücksetzen können. Die Versionsnummern werden sequenziell ab dem von Remote Config gespeicherten Anfangswert erhöht.
Alle Vorlagen enthalten wie gezeigt ein version-Feld mit Metadaten zu dieser spezifischen Version.
Sie können Remote Config-Vorlagen nach Bedarf in der Firebase-Konsole auf der Seite DevOps & Engagement > Remote Config > Änderungsverlauf löschen.
Remote Config-Vorlagenversionen verwalten
In diesem Abschnitt wird beschrieben, wie Sie Versionen Ihrer Remote Config-Servervorlage 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-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf.
Wählen Sie oben rechts das Uhrsymbol aus.
Dadurch wird die Seite Änderungsverlauf geöffnet, auf der alle gespeicherten Vorlagenversionen in einem Listenmenü auf der rechten Seite aufgeführt sind.
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 und Weise, wie sie vorgenommen wurde.
Bestimmte Version der Vorlage Remote Config abrufen
Sie können jede bestimmte gespeicherte Version der Remote Config-Vorlage abrufen. So rufen Sie eine gespeicherte Vorlagenversion ab:
Rufen Sie in der Firebase-Konsole 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 rechts aus.
Sie können sich einen detaillierten Vergleich der aktiven Vorlage und einer anderen gespeicherten Version ansehen. Bewegen Sie dazu 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 setzen Sie eine Vorlage zurück:
Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Änderungsverlauf auf.
Suchen Sie rechts oben auf der Seite nach der Optionsschaltfläche für frühere Vorlagenversionen, für die ein Rollback möglich ist.
Klicken Sie darauf und bestätigen Sie dies nur, 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.
Beachten Sie, dass durch diesen Rollback-Vorgang eine neue nummerierte Version erstellt wird. Wenn Sie beispielsweise von Version 10 auf Version 6 zurücksetzen, wird eine neue Kopie von Version 6 erstellt, die sich vom Original nur dadurch unterscheidet, dass die Versionsnummer 11 lautet. Die ursprüngliche Version 6 wird weiterhin gespeichert, sofern sie 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-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf.
Klicken Sie auf
Änderungsverlauf .Wechseln Sie zu der Vorlage, die Sie löschen möchten, klicken Sie auf
Mehr und wählen Sie dann Löschen aus.Wenn Sie zur Bestätigung des Löschvorgangs aufgefordert werden, 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 einzubinden, Konfigurationsupdates zu automatisieren und Parameter und Werte über mehrere Projekte hinweg synchron zu halten.
Sie können die derzeit aktive Remote Config-Vorlage aus der Firebase-Konsole herunterladen. Anschließend können Sie die exportierte JSON-Datei aktualisieren und im selben Projekt oder in einem neuen oder vorhandenen Projekt veröffentlichen.
Angenommen, Sie haben mehrere Projekte, die verschiedene Phasen des 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 hochstufen, 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 zu einem anderen 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-Vorlage herunter.
- Remote Config-Vorlage validieren
- Veröffentlichen Sie die Remote Config-Vorlage.
Aktuelle Remote Config-Vorlage herunterladen
Verwenden Sie den folgenden Befehl, um die aktive Remote Config-Vorlage im JSON-Format herunterzuladen:
Rufen Sie in der Firebase-Konsole 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 für die Datei aus und klicken Sie dann auf Speichern.
Remote Config-Vorlage validieren
Servervorlagen werden validiert, wenn Sie versuchen, sie über die Firebase-Konsole zu veröffentlichen. Bedingungen, die die Regel Nutzer in zufälligem Prozentwert verwenden, können importiert werden. Nicht unterstützte Bedingungen generieren jedoch beim Upload einen Fehler. Wenn Sie eine Vorlage veröffentlichen möchten, 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 wird um eins erhöht. Da die gesamte Konfiguration ersetzt wird, wird ein Parameter, den Sie aus der JSON-Datei löschen und veröffentlichen, 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.
So veröffentlichen Sie Ihre Vorlage:
Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Parameter oder Bedingungen auf.
Öffnen Sie das
Menü und wählen Sie Aus einer Datei veröffentlichen aus.Wenn Sie dazu aufgefordert werden, klicken Sie auf Durchsuchen, rufen Sie die Remote Config-Datei auf, die Sie veröffentlichen möchten, wählen Sie sie aus und klicken Sie dann auf Auswählen.
Die Datei wird validiert. Wenn die Validierung erfolgreich ist, klicken Sie auf Veröffentlichen, um die Konfiguration sofort für Ihre Apps und Nutzer verfügbar zu machen.
Nächste Schritte
- Remote Config in Serverumgebungen verwenden
- Probieren Sie serverseitiges Remote Config mit Cloud Functions for Firebase und Agent Platform aus.