Szablony Zdalnej konfiguracji i obsługa wersji

Szablony Remote Config to zestawy parametrów i warunków w formacie JSON utworzone na potrzeby projektu w Firebase. Remote Config porządkuje konfiguracje w szablony, które można tworzyć, aktualizować, wersjonować i przywracać.

W zależności od architektury możesz tworzyć szablony klienta, szablony serwera lub oba te rodzaje szablonów i nimi zarządzać:

  • Szablony klienta: udostępniaj konfiguracje instancjom aplikacji klienckich na platformach Apple, Android, Web, Flutter, Unity i C++. Szablony klienta obsługują warunki oparte na odbiorcach Google Analytics, wersjach aplikacji, platformie, języku urządzenia, kraju, percentylach użytkowników i niestandardowych sygnałach.

  • Szablony serwera: udostępniaj konfiguracje środowiskom backendu, takim jak Cloud Run, Cloud Functions for Firebase lub serwery kontenerowe, za pomocą Firebase Admin SDK w językach Node.js, Python, Go i Java. Szablony po stronie serwera oceniają parametry po stronie serwera z niemal zerowym opóźnieniem, korzystając z niestandardowych sygnałów serwera i losowych procentowych wdrożeń.

Porównanie szablonów klienta i serwera

Szablony klienta i serwera są przechowywane niezależnie w projekcie Firebase. W tabeli poniżej znajdziesz różnice między szablonami klienta i serwera:

Funkcja Szablony klienta Szablony serwerów
Środowiska docelowe Aplikacje klienckie (Apple, Android, Web, Flutter, Unity, C++) środowiska serwerów (Cloud Run, Cloud Functions for Firebase, GKE, usługi backendu);
Obsługiwane pakiety SDK Pakiety SDK klienta Firebase Firebase Admin SDK (Node.js, Python, Go, Java)
Narzędzia do zarządzania Firebase console, Firebase CLI, REST API, Firebase Admin SDK Konsola Firebase
Lokalizacja konsoli Parametry i warunki Parametry i warunki
Pobieranie domyślnych ustawień szablonu Obsługiwane (XML na Androidzie, PLIST na iOS, JSON w internecie) Nie dotyczy (wartości domyślne zdefiniowane w kodzie serwera lub backendzie)
Szczegółowy przewodnik Zarządzanie szablonami klientów Zarządzanie szablonami serwerów

Cykl życia i obsługa wersji szablonu

Niezależnie od tego, czy pracujesz z szablonami klienta czy serwera, Remote Config zapewnia wbudowaną kontrolę wersji i zarządzanie cyklem życia:

Tworzenie i śledzenie wersji

Za każdym razem, gdy aktualizujesz parametry lub warunki, Remote Config tworzy nową wersję szablonu Remote Config i zapisuje poprzedni szablon jako wersję, którą możesz w razie potrzeby pobrać lub przywrócić. Numery wersji są zwiększane sekwencyjnie od wartości początkowej przechowywanej przez Remote Config.

Wszystkie szablony zawierają pole version z metadanymi dotyczącymi konkretnej wersji, takimi jak:

  • versionNumber: numer kolejnej wersji szablonu.
  • updateTime: sygnatura czasowa opublikowania szablonu.
  • updateUser: adres e-mail lub tożsamość użytkownika, który dokonał aktualizacji.
  • updateOrigin: sposób wprowadzenia zmiany (np. CONSOLE, REST_API lub ADMIN_SDK_NODE).
  • updateType: charakter zmiany (np. INCREMENTAL_UPDATE lub FORCED_UPDATE).

Limity i przechowywanie wersji

Obowiązuje łączny limit 300 zapisanych wersji na typ szablonu (300 szablonów klienta i 300 szablonów serwera), który obejmuje numery zapisanych wersji usuniętych szablonów. Jeśli w trakcie cyklu życia projektu opublikujesz więcej niż 300 wersji szablonu danego typu, najstarsze wersje zostaną usunięte, aby zachować maksymalnie 300 wersji tego typu.

Przywrócone

W każdej chwili możesz przywrócić dowolną zapisaną wersję szablonu. Gdy przywrócisz poprzednią wersję, Remote Config utworzy nową wersję, której zawartość będzie zgodna z wybraną wersją historyczną. Na przykład przywrócenie wersji 6 z wersji 10 spowoduje utworzenie wersji 11 z konfiguracją z wersji 6.

Import i eksport

Możesz pobrać aktywny szablon jako plik JSON i opublikować go w tym samym lub innym projekcie. Dzięki tej funkcji możesz:

  • Przechowuj definicje szablonów w systemie kontroli wersji (np. Git).
  • integracja wdrożeń konfiguracji z potokami CI/CD;
  • Przenoszenie konfiguracji między etapami (np. z projektu programistycznego lub przejściowego do produkcyjnego).
  • Migracja konfiguracji między projektami.

Parametry i wartości parametrów utworzone specjalnie jako warianty w eksperymencie A/B Testing nie są uwzględniane w wyeksportowanych szablonach.

Domyślne ustawienia szablonu

W przypadku aplikacji klienckich możesz pobrać pliki zawierające domyślne wartości parametrów w formacie XML, PLIST lub JSON, aby dołączyć je do aplikacji. Instrukcje znajdziesz w artykule Pobieranie domyślnych wartości szablonu Remote Config.

Dalsze kroki