Biblioteka zmiennych CI/CD

Używaj bibliotek zmiennych w Fabric do zarządzania konfiguracjami na różnych etapach potoku release oraz do zapisywania wartości w Gicie. W tym artykule wyjaśniono, jak używać bibliotek zmiennych w kontekście zarządzania cyklem życia oraz ciągłej integracji i ciągłego dostarczania (CI/CD).

Biblioteki zmiennych i potoki wdrażania

Biblioteki zmiennych i ich wartości można stosować w potokach wdrażania, aby zarządzać wartościami zmiennych na różnych etapach.

Pamiętaj o tych ważnych informacjach:

• Wszystkie zestawy wartości w bibliotece zmiennych są dostępne na wszystkich etapach potoku wdrażania, ale na danym etapie aktywny jest tylko jeden zestaw.

• Aktywna wartość ustawiona dla każdego etapu jest wybierana niezależnie. Możesz zmienić go w dowolnym momencie.

• Po pierwszym wdrożeniu lub zatwierdzeniu biblioteki zmiennych aktywny zestaw biblioteki ma wartość domyślną. Tę wartość można zmienić, korzystając z nowo utworzonej biblioteki zmiennych w etapie docelowym lub repozytorium i zmieniając aktywny zestaw.

  

• Chociaż wdrożenia nie mają wpływu na wybrany aktywny zestaw wartości na każdym etapie, można zaktualizować same wartości w bibliotece zmiennych. Produkt konsumencki w swoim obszarze roboczym (na przykład potok) automatycznie otrzymuje poprawną wartość z aktywnego zestawu wartości.

Następujące operacje na zmiennych lub zestawach wartości w jednym etapie potoku wdrażania powodują, że biblioteka zmiennych zostanie odzwierciedlona jako inne źródło formularzaw porównaniu z tym samym elementem na innym etapie:

• Dodane, usunięte lub edytowane zmienne
• Dodane lub usunięte zestawy wartości
• Nazwy zmiennych
• Kolejność zmiennych

Prosta zmiana aktywnego zestawu wartości nie jest rejestrowana jako inne źródło formularza podczas porównywania. Aktywny zestaw wartości jest częścią konfiguracji elementu, ale nie jest uwzględniony w definicji. Dlatego nie pojawia się w porównaniu potoków wdrażania i nie jest nadpisywana przy każdym wdrożeniu.

Biblioteki zmiennych i integracja z usługą Git

Podobnie jak inne elementy sieci szkieletowej, biblioteki zmiennych można zintegrować z usługą Git na potrzeby kontroli źródła. Elementy biblioteki zmiennych są przechowywane jako foldery, którymi można zarządzać i synchronizować je między usługą Fabric a dostawcą Git.

Uprawnienia do elementu są sprawdzane podczas aktualizacji w Git i zatwierdzania zmian.

Schemat elementu biblioteki zmiennych jest obiektem JSON zawierającym cztery części:

• Folder dla zestawów wartości
• Ustawienia
• Platform.json, automatycznie wygenerowany plik
• Zmienne

Zestawy wartości

Folder biblioteki zmiennych zawiera podfolder o nazwie valueSets. Ten folder zawiera plik JSON dla każdego zestawu wartości. Ten plik JSON zawiera tylko wartości zmiennych dla wartości innych niż domyślne w tym zestawie wartości.

Aby uzyskać więcej informacji na temat pliku zestawu wartości, zobacz zestawy wartości i przykład zestawu wartości.

Wartości zmiennych, które nie znajdują się w tym pliku, są pobierane z domyślnego zestawu wartości.

Ustawienia

Plik settings.json zawiera ustawienia biblioteki zmiennych.

Aby uzyskać więcej informacji, zobacz zmienne i przykład settings.json.

Zmienne

Plik variables.json zawiera nazwy zmiennych i ich wartości domyślne.

Aby uzyskać więcej informacji, zobacz przykład variables.json.

Uwagi i ograniczenia

Ograniczenia dotyczące zmiennych

• Może istnieć maksymalnie 1000 zmiennych i maksymalnie 1000 zestawów wartości, o ile spełnisz oba te wymagania:

  • Całkowita liczba komórek w zestawach wartości alternatywnych jest mniejsza niż 10 000.
  • Rozmiar elementu nie przekracza 1 MB.

  Te wymagania są weryfikowane podczas zapisywania zmian.

• Pole notatki może mieć maksymalnie 2048 znaków.

• Pole opisu zestawu wartości może zawierać maksymalnie 2048 znaków.

Ograniczenia dotyczące zestawów wartości alternatywnych

• Zestawy wartości alternatywnych w bibliotece zmiennych są wyświetlane w kolejności, w której zostały dodane. Obecnie nie można zmienić ich kolejności w interfejsie użytkownika. Aby zmienić kolejność, przeprowadź bezpośrednią edycję pliku JSON.
• Nazwa każdego zestawu wartości musi być unikatowa w bibliotece zmiennych.
• Nazwy zmiennych muszą być unikalne w bibliotece zmiennych. Jeśli znajdują się w różnych elementach, możesz mieć dwie zmienne o tej samej nazwie w obszarze roboczym.
• W bibliotece zmiennych w danym momencie zawsze aktywny jest jeden (i tylko jeden) zestaw wartości. Nie można usunąć zestawu wartości, gdy jest ona aktywna. Aby go usunąć, najpierw ustaw jako aktywny inny zestaw wartości. Dla każdego etapu potoku wdrażania można mieć inny aktywny zestaw wartości.

Treści powiązane

• Format kodu źródłowego integracji usługi Git