Szablony Zdalnej konfiguracji i obsługa wersji

.

Szablony Zdalnej konfiguracji to zbiory 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
  }
}

W konsoli Firebase możesz wykonywać te zadania związane z zarządzaniem wersjami:

  • Wyświetl listę wszystkich przechowywanych wersji szablonów
  • Pobieranie konkretnej wersji
  • Przywracanie określonej wersji klienta
  • Usuń szablony Zdalnej konfiguracji ze zmiany 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 opublikujesz więcej niż 300 wersji szablonów według typu szablonu w czasie trwania projektu, najwcześniejszych wersji zostaje usuniętych, zachowując maksymalnie 300 tego typu.

Po każdym zaktualizowaniu parametrów Zdalna konfiguracja tworzy nowy szablon Zdalnej konfiguracji z obsługą wersji 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 Zdalną konfigurację. Wszystkie szablony zawierają pole version, jak pokazano na ilustracji, z metadanymi na ten temat. konkretnej wersji.

W razie potrzeby możesz usunąć szablony Zdalnej konfiguracji z Historia zmian w w konsoli Zdalnej konfiguracji.

Zarządzanie wersjami szablonów Zdalnej konfiguracji

W tej sekcji dowiesz się, jak zarządzać wersjami Zdalnej konfiguracji. szablon.

Wyświetl listę wszystkich zapisanych wersji szablonu Zdalnej konfiguracji

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

  1. W konsoli Firebase otwórz Zdalną konfigurację.

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

    Otworzy się Historia zmian w menu po prawej stronie z listą wszystkich przechowywanych wersji szablonów.

    Lista szablonów zawiera metadane wszystkich przechowywanych wersji, w tym czas aktualizacji, nazwę użytkownika, który ją dokonał, i sposób jej przeprowadzenia.

Pobieranie konkretnej wersji szablonu Zdalnej konfiguracji

Możesz pobrać wszystkie zapisane dane, wersji szablonu Zdalnej konfiguracji. 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ą.

Cofnięcie do określonej zapisanej wersji szablonu Zdalnej konfiguracji

Możesz wrócić do dowolnego zapisanego wersji 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 przejście z wersji 10 na wersję 6, tworzy nową kopię wersji 6, różniącą się niż oryginalna wersja, pod warunkiem, że 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 Zdalnej konfiguracji

Szablony Zdalnej konfiguracji możesz usunąć z poziomu konsoli Firebase. Do usuń szablon Zdalnej konfiguracji:

1. Z poziomu Zdalnej konfiguracji 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 Zdalnej konfiguracji

Pobierz i opublikuj szablony Zdalnej konfiguracji, aby zintegrować je ze swoim kontrola źródła i systemy kompilacji, automatyzowanie aktualizacji konfiguracji oraz zachowywanie parametrów i wartości w wielu projektach.

Możesz pobrać aktywny szablon Zdalnej konfiguracji z poziomu 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 Eksperyment z testami A/B nie jest uwzględniany w eksportowanych szablonach.

Aby wyeksportować lub zaimportować szablony Zdalnej konfiguracji:

  1. Pobierz aktualny szablon Zdalnej konfiguracji.
  2. Zweryfikuj szablon Zdalnej konfiguracji.
  3. Opublikuj szablon Zdalnej konfiguracji.

Pobierz bieżący szablon Zdalnej konfiguracji

Użyj tego kodu, aby pobrać aktywny szablon Zdalnej konfiguracji w: Format JSON:

  1. Z poziomu Parametry lub warunki Zdalnej konfiguracji 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 konsoli 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.

Opublikuj szablon Zdalnej konfiguracji.

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

Opublikowanie szablonu powoduje zastąpienie całego istniejącego szablonu konfiguracji zaktualizowany i zwiększa wersję szablonu o jeden. 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 aplikacji i użytkowników. W razie potrzeby przywrócić poprzednią wersję.

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

  1. Z poziomu Parametry lub warunki Zdalnej konfiguracji otwórz Menu, i wybierz Opublikuj z pliku.
  2. Gdy pojawi się komunikat, kliknij Przeglądaj, przejdź do plik Zdalnej konfiguracji, 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