Szablony Zdalnej konfiguracji i obsługa wersji

Remote Config to zbiory parametrów i warunków w formacie JSON utworzone dla Twojego 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 klientów, szablony serwerów lub oba rodzaje szablonów:

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

  • Szablony serwera: udostępniaj konfiguracje środowiskom backendu, takim jak Cloud Run, Cloud Functions for Firebase lub serwery w kontenerach, za pomocą Firebase Admin SDK w przypadku Node.js, Pythona, Go i Javy. Szablony serwera oceniają parametry po stronie serwera z niemal zerowym opóźnieniem, korzystając z niestandardowych sygnałów serwera i wdrażania losowego procenta.

Porównywanie szablonów klienta i serwera

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

Funkcja Szablony klientów Szablony serwerów
Środowiska docelowe Aplikacje klienckie (Apple, Android, internetowe, Flutter, Unity, C++) Środowiska serwerowe (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 konsola, Firebase interfejs CLI, interfejs REST API, Firebase Admin SDK Konsola Firebase
Lokalizacja konsoli Parametry i warunki Parametry i warunki
Pobieranie domyślnych ustawień szablonu Obsługiwane (XML na Androida, PLIST na iOS, JSON w przypadku internetu) Nie dotyczy (wartości domyślne zdefiniowane w kodzie serwera lub backendzie)
Szczegółowy przewodnik Zarządzanie szablonami klientów Zarządzanie szablonami serwera

Cykl życia szablonu i obsługa wersji

Niezależnie od tego, czy pracujesz z szablonami klienta czy szablonami 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 nowy szablon z numerem wersjiRemote Config i zapisuje poprzedni szablon jako wersję, którą możesz w razie potrzeby przywrócić lub wycofać zmiany. Numery wersji są zwiększane kolejno od wartości początkowej przechowywanej przez Remote Config.

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

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

Limity wersji i okres przechowywania

Łączny limit przechowywanych wersji w całym okresie istnienia szablonu wynosi 300 na typ szablonu (300 szablonów klienta i 300 szablonów serwera), co obejmuje przechowywane numery wersji usuniętych szablonów. Jeśli w trakcie trwania projektu opublikujesz więcej niż 300 wersji szablonu danego typu, najstarsze wersje zostaną usunięte, a maksymalna liczba wersji tego typu wyniesie 300.

Przywrócone

W każdej chwili możesz wycofać zmiany do dowolnej zapisanej wersji szablonu. Gdy cofniesz zmiany, Remote Config utworzy nową wersję, której zawartość będzie zgodna z wybraną wersją historyczną. Na przykład wycofanie zmian z wersji 10 do wersji 6 spowoduje utworzenie wersji 11 z konfiguracją z wersji 6.

Importowanie i eksportowanie

Aktywny szablon możesz pobrać 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).
  • Integrowanie wdrożeń konfiguracji z potokami CI/CD.
  • Promowanie konfiguracji na różnych etapach (np. z projektu programistycznego lub przejściowego do projektu produkcyjnego).
  • przenosić konfiguracje między projektami;

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

Wartości domyślne 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