Remote Config-Vorlagen und -Versionierung


Remote Config-Vorlagen sind JSON-formatierte Parameter und Bedingungen, die Sie für Ihr Firebase-Projekt erstellt haben. Sie können Clientvorlagen erstellen, aus denen Ihre App Werte abrufen kann, und Servervorlagen, aus denen Serverclients Werte abrufen können.

In diesem Abschnitt werden Servervorlagen behandelt. Um mehr über kundenspezifische auf „Vorlagen“ klicken, Clientvorlagen

Sie ändern und verwalten die Vorlage mit der Firebase-Konsole, in der den Inhalt der Vorlage im grafischen Format im Parameter und Bedingungen Registerkarten.

Hier sehen Sie ein Beispiel für eine Server-Vorlagedatei:

{
  "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 die folgenden Versionsverwaltungsaufgaben mit der Firebase-Konsole ausführen:

  • Alle gespeicherten Vorlagenversionen auflisten
  • Bestimmte Version abrufen
  • Rollback auf eine bestimmte Clientversion durchführen
  • Löschen Sie Remote Config Vorlagen aus der Änderung Verlauf Seite

Es gibt ein Gesamtlimit von 300 gespeicherten Versionen pro Vorlagentyp. (300 Client-Vorlagen und 300 Servervorlagen), einschließlich der gespeicherten Versionsnummern für gelöschte Vorlagen. Wenn Sie mehr als 300 Vorlagenversionen pro Vorlagentyp während der Lebensdauer eines Projekts, früheste Versionen werden gelöscht, wobei maximal 300 Versionen der für diesen Typ.

Jedes Mal, wenn Sie Parameter aktualisieren, erstellt Remote Config einen neue versionierte Vorlage Remote Config und speichert die vorherige Vorlage als eine Version, die Sie bei Bedarf abrufen oder zu der Sie ein Rollback durchführen können. Versionsnummern werden sequentiell ausgehend vom Anfangswert erhöht, der von Remote Config gespeichert wird. Alle Vorlagen enthalten wie gezeigt das Feld version mit Metadaten dazu. bestimmte Version.

Sie können Remote Config Vorlage nach Bedarf aus dem Änderungsverlauf Seite an der Remote Config-Konsole.

Remote Config Vorlagenversionen verwalten

In diesem Abschnitt wird beschrieben, wie du Versionen deiner Remote Config verwalten kannst Vorlage.

Alle gespeicherten Versionen der Vorlage Remote Config auflisten

Sie können eine Liste aller alle gespeicherten Versionen der Vorlage Remote Config. Vorgehensweise:

  1. Öffnen Sie Remote Config in der Firebase-Konsole.

  2. Wählen Sie dann im Parameter wählen Sie die Option „Uhr“ aus, das oben rechts angezeigt wird.

    Daraufhin wird die Seite Änderungsverlauf geöffnet. Rechts in einem Listenmenü werden alle gespeicherten Vorlagenversionen aufgelistet.

    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.

Eine bestimmte Version der Vorlage Remote Config abrufen

Sie können eine bestimmte gespeicherte Version der Remote Config-Vorlage abrufen. So rufen Sie eine gespeicherte Vorlage ab: Version:

  1. Detailbereich öffnen von Änderungsverlauf:

  2. Wenn Sie Details zu einer anderen Version in der Liste aufrufen möchten, wählen Sie sie im Menü rechts aus.

  3. Wenn Sie eine detaillierte Differenz zwischen der aktiven Vorlage und 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 auf eine bestimmte gespeicherte Version der Vorlage Remote Config durchführen

Sie können zu jedem gespeicherten Version der Vorlage. So führen Sie ein Rollback für eine Vorlage durch:

  1. Suchen Sie die Optionsschaltfläche oben rechts auf dem Änderungsverlauf Seite. Bestätigen Sie dies nur, wenn Sie sicher sind, dass ein Rollback zu Version und verwenden diese Werte sofort für alle Apps und Nutzer.

Beachten Sie, dass durch diesen Rollback-Vorgang eine neue nummerierte Version erstellt wird. Beispiel: Ein Rollback von Version 10 auf Version 6 eine neue Kopie von Version 6 erstellt, nur dadurch, dass die Versionsnummer 11 ist. Die Originalversion 6 unter der Annahme, dass das Ablaufdatum noch nicht erreicht 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. Bis Remote Config-Vorlage löschen:

1. Aus der Remote Config Parameter klicken Sie auf Änderungsverlauf:

  1. Wechseln Sie zu der Vorlage, die Sie löschen möchten, und klicken Sie auf Mehr und dann Löschen.

  2. Wenn Sie dazu aufgefordert werden, den Löschvorgang 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 Ihr Versionsverwaltung nutzen und Systeme erstellen, Konfigurationsaktualisierungen automatisieren und Parameter beibehalten und Werte über mehrere Projekte hinweg zu synchronisieren.

Sie können die derzeit aktive Vorlage „Remote Config“ herunterladen über die Firebase-Konsole. Anschließend können Sie die exportierten JSON-Datei und veröffentlichen Sie sie im selben Projekt oder in einem neuen oder Projekt arbeiten.

Nehmen wir an, Sie haben mehrere Projekte, die verschiedene Phasen Ihres Softwareentwicklungszyklus wie Entwicklung, Test, Staging und Produktion Umgebungen. In diesem Fall können Sie eine vollständig getestete Vorlage aus Ihrem Staging-Umgebung in Ihre Produktionsumgebung übertragen, indem Sie sie von der und veröffentlichen Sie es in Ihrem Produktionsprojekt.

Sie können diese Methode auch verwenden, um Konfigurationen von einem Projekt zu oder ein neues Projekt mit Parametern und Werten eines Projekts erstellt.

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

So exportieren und importieren Sie Remote Config Vorlagen:

  1. Laden Sie die aktuelle Remote Config-Konfigurationsvorlage herunter.
  2. Validiere die Vorlage Remote Config.
  3. Veröffentlichen Sie die Vorlage Remote Config.

Aktuelle Remote Config-Vorlage herunterladen

So laden Sie die aktive Vorlage Remote Config herunter: JSON-Format:

  1. Öffnen Sie auf dem Tab Remote Config Parameter oder Bedingungen das Menü und wählen Sie Aktuelle Konfigurationsdatei herunterladen aus.
  2. Klicken Sie auf die Aufforderung 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, über die Firebase-Konsole. Hinweis: Nutzer in zufälligen Prozentsätzen können importiert, aber jede nicht unterstützte Bedingung führt beim Hochladen zu einem Fehler. Wenn Sie versuchen, eine Vorlage zu veröffentlichen, die ursprünglich aus einer Kundenvorlage exportiert wurde, entfernen Sie zuerst alle clientspezifischen Bedingungen.

Vorlage „Remote Config“ veröffentlichen

Nehmen Sie nach dem Herunterladen einer Vorlage alle erforderlichen Änderungen am JSON-Inhalt vor und können Sie sie in einem Projekt veröffentlichen.

Beim Veröffentlichen einer Vorlage wird die gesamte vorhandene Konfigurationsvorlage durch die aktualisierte Datei und erhöht die Vorlagenversion um eins. Da die gesamte Konfiguration ersetzt werden, wenn Sie einen Parameter aus der JSON-Datei löschen und veröffentlichen, wird der Parameter vom Server gelöscht und ist nicht mehr verfügbar für die Kundschaft.

Nach der Veröffentlichung sind Änderungen an Parametern und Werten sofort verfügbar für Ihre Apps und Nutzer. Bei Bedarf können Sie Rollback auf eine frühere Version durchführen.

Verwenden Sie die folgenden Befehle, um Ihre Vorlage zu veröffentlichen:

  1. Wählen Sie im Remote Config-Parameter oder Bedingungen öffnen Sie das Menü, und wählen Sie Aus einer Datei veröffentlichen aus.
  2. Wenn Sie dazu aufgefordert werden, klicken Sie auf Durchsuchen, gehen Sie zum Remote Config Datei, die Sie veröffentlichen möchten, und klicken Sie dann auf Auswählen.
  3. Die Datei wird überprüft. Wenn der Vorgang erfolgreich war, klicken Sie auf Klicken Sie auf Veröffentlichen, um die Konfiguration sofort für Ihr Konto verfügbar zu machen. Apps und Nutzer.

Nächste Schritte