Szablony Zdalnej konfiguracji i obsługa wersji


Remote Config szablony to zestawy w formacie JSON parametrów i warunków utworzonych przez Ciebie na potrzeby projektu Firebase. Ty może tworzyć szablony klientów, z których aplikacja pobiera wartości; serwerów, z których klienty serwera mogą pobierać wartości.

W tej sekcji omówione są szablony serwerów. Więcej informacji o konfiguracjach na poziomie klienta szablonów, kliknij Szablony klientów.

Szablon możesz modyfikować i zarządzać nim w konsoli Firebase, która wyświetla zawartość szablonu w formacie graficznym w Parametry oraz Warunki .

Oto przykład pliku szablonu serwera:

{
  "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
  }
}

Za pomocą konsoli Firebase możesz wykonywać te zadania zarządzania wersjami:

  • Wyświetl listę wszystkich przechowywanych wersji szablonów
  • Pobieranie konkretnej wersji
  • Przywracanie określonej wersji klienta
  • Usuń szablony (Remote Config) z sekcji Zmień historia strona

Obowiązuje limit 300 przechowywanych wersji bezterminowo na typ szablonu. (300 szablonów klienta i 300 szablonów serwera), w tym zapisane numerów wersji usuniętych szablonów. Jeśli w trakcie trwania projektu opublikujesz więcej niż 300 wersji szablonu na typ szablonu, najstarsze wersje zostaną usunięte, zachowując maksymalnie 300 wersji tego typu.

Za każdym razem, gdy zaktualizujesz parametry, Remote Config tworzy makro ma nową wersję szablonu Remote Config i przechowuje poprzedni jako wersję, którą możesz pobrać lub przywrócić zależnie od potrzeb. Numery wersji są zwiększane sekwencyjnie od wartości początkowej zapisanej przez funkcję Remote Config. Wszystkie szablony zawierają pole version, jak pokazano na ilustracji, z metadanymi na ten temat. konkretnej wersji.

W razie potrzeby możesz usunąć Remote Config szablonu z Historia zmian w w konsoli Remote Config.

Zarządzaj wersjami szablonu Remote Config

Z tej sekcji dowiesz się, jak zarządzać wersjami aplikacji Remote Config szablon.

Wyświetlanie listy wszystkich zapisanych wersji szablonu Remote Config

Możesz pobrać listę wszystkich zapisanych wersji szablonu Remote Config. Aby to zrobić:

  1. W konsoli Firebase otwórz Remote Config.

  2. Następnie z poziomu Parametry wybierz „zegar” w prawym górnym rogu.

    Spowoduje to otwarcie strony Historia zmian, na której w menu po prawej stronie znajdziesz wszystkie przechowywane wersje szablonu.

    Lista szablonów zawiera metadane wszystkich zapisanych wersji, w tym czas wprowadzenia aktualizacji, użytkownika, który ją wprowadził, oraz sposób jej wprowadzenia.

Pobierz konkretną wersję szablonu Remote Config

Możesz pobrać wszystkie zapisane dane, wersji szablonu Remote Config. Aby pobrać zapisany szablon wersja:

  1. Otwórz panel szczegółów Historia zmian.

  2. Aby wyświetlić szczegóły innej wersji na liście, wybierz ją po prawej stronie .

  3. Wyświetl szczegółowe różnice między aktywnym szablonem a każdą inną zapisaną wersją najechanie kursorem na menu kontekstowe dowolnej niewybranej wersji i kliknij Porównaj z wybraną wersją.

Wycofaj zmiany do określonej zapisanej wersji szablonu Remote Config

Możesz przywrócić dowolną zapisaną wersję szablonu. Aby przywrócić poprzednią wersję szablonu:

  1. W prawym górnym rogu strony Historia zmian stronę. Kliknij i potwierdź tę opcję tylko wtedy, gdy na pewno chcesz wrócić do i używać tych wartości od razu w przypadku wszystkich aplikacji i użytkowników.

Pamiętaj, że ta operacja przywracania tworzy nową wersję numerowaną. Na przykład przywrócenie wersji 10 do wersji 6 spowoduje utworzenie nowej kopii wersji 6, która różni się od oryginału tylko tym, że jej numer wersji to 11. Oryginalna wersja 6 jest nadal przechowywany, zakładając, że nie upłynął jeszcze termin wygaśnięcia wersji, a wersja 11 stanie się szablonem aktywnym.

Usuń szablon Remote Config

Szablony Remote Config możesz usuwać w konsoli Firebase. Aby usunąć szablon Remote Config:

1. Z lig Remote Config Parametry kliknij Historia zmian.

  1. Przejdź do szablonu, który chcesz usunąć, i kliknij Więcej, a następnie wybierz Usuń.

  2. Gdy pojawi się prośba o potwierdzenie usunięcia, kliknij Usuń.

Pobieranie i publikowanie szablonów Remote Config

Pobierz i opublikuj szablony Remote Config, aby zintegrować je z systemami kontroli źródła i kompilacji, zautomatyzować aktualizacje konfiguracji oraz zsynchronizować parametry i wartości w różnych projektach.

Możesz pobrać aktywny szablon Remote Config w konsoli Firebase. Następnie możesz zaktualizować wyeksportować plik JSON i opublikować go w tym samym projekcie albo opublikować w nowym lub istniejącego projektu.

Załóżmy, że masz kilka projektów reprezentujących różne etapy cykl tworzenia oprogramowania, np. programowanie, testowanie, testowanie i produkcja w różnych środowiskach. W takiej sytuacji możesz promować w pełni przetestowany szablon ze swojej środowiska testowego do środowiska produkcyjnego. Pobierz je ze swojego i opublikować projekt w projekcie produkcyjnym.

Za pomocą tej metody możesz też przenieść konfiguracje z jednego projektu do inny lub zapełnić nowy projekt parametrami i wartościami z i gotowego projektu.

Parametry i ich wartości utworzone specjalnie jako warianty w parametrze A/B Testing eksperyment nie jest uwzględniony w eksportowanych szablonach.

Aby wyeksportować i zaimportować Remote Config szablon:

  1. Pobierz aktualny szablon konfiguracji Remote Config.
  2. Zweryfikuj szablon Remote Config.
  3. Opublikuj szablon Remote Config.

Pobierz bieżący szablon Zdalnej konfiguracji

Aby pobrać aktywny szablon Remote Config w formacie JSON:

  1. Z poziomu Remote Config Parametry lub warunki kartę, otwórz menu i wybierz Pobierz bieżący plik konfiguracyjny.
  2. Gdy pojawi się prośba, kliknij Pobierz plik konfiguracyjny i wybierz lokalizację, w której chcesz zapisać plik, a potem kliknij Zapisz.

Weryfikowanie szablonu Zdalnej konfiguracji

Szablony serwera są weryfikowane, gdy próbujesz publikować z poziomu Konsola Firebase. Pamiętaj, że warunki losowego procentu użytkowników mogą być zaimportowane, ale każdy nieobsługiwany warunek spowoduje wystąpienie błędu podczas przesyłania. Jeśli próbujesz opublikować szablon, który został pierwotnie wyeksportowany z szablon klienta, najpierw usuń wszystkie warunki specyficzne dla tego klienta.

Publikowanie szablonu Remote Config

Po pobraniu szablonu wprowadź niezbędne zmiany w treści JSON. aby go sprawdzić, możesz opublikować go w projekcie.

Publikowanie szablonu powoduje zastąpienie całego dotychczasowego szablonu konfiguracji zaktualizowanym plikiem i zwiększenie wersji szablonu o 1. Ponieważ cały zostanie zastąpiona, jeśli usuniesz parametr z pliku JSON po jego opublikowaniu, parametr zostanie usunięty z serwera i nie będzie już dostępny nowych klientów.

Po opublikowaniu zmiany parametrów i wartości są dostępne od razu do Twoich aplikacji i użytkowników. W razie potrzeby przywrócić poprzednią wersję.

Aby opublikować szablon, użyj tych poleceń:

  1. Z poziomu Remote Config Parametry lub warunki otwórz menu, i wybierz Opublikuj z pliku.
  2. Gdy pojawi się komunikat, kliknij Przeglądaj, przejdź do Remote Config plik, który chcesz opublikować, a następnie kliknij Wybierz.
  3. Plik zostanie zweryfikowany. Jeśli operacja się uda, kliknij Opublikuj, aby od razu udostępnić konfigurację aplikacji i użytkowników.

Dalsze kroki