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.

Zrzut ekranu przedstawiający potok wdrażania.

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.

  • Gdy biblioteka zmiennych jest wdrażana na pustym etapie, wdrożenie tworzy przestrzeń roboczą, w której aktywny jest zbiór wartości domyślnej . Jeśli środowisko docelowe wymaga innego zestawu wartości, otwórz bibliotekę zmiennych w docelowej przestrzeni roboczej, ustaw wymagany zestaw wartości jako aktywny i zapisz bibliotekę zmiennych przed uruchomieniem zależności lub działań planu wdrożenia.

    Zrzut ekranu przedstawiający polecenie umożliwiające zmianę aktywnego zestawu wartości z domyślnej na wartość alternatywną ustawioną w potoku wdrażania.

  • 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

Zrzut ekranu porównanych potoków wdrażania, na którym biblioteka zmiennych jest pokazana jako różna na dwóch etapach.

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.

Używaj wartości biblioteki zmiennych w planie wdrożenia

Akcja planu wdrożenia może używać odniesienia do biblioteki zmiennej zamiast wartości parametru literalnego. Po uruchomieniu wdrożenia Fabric rozwiązuje referencję, używając aktywnego zestawu wartości biblioteki zmiennych w docelowej przestrzeni roboczej. Pozwala to tej samej akcji używać wartości specyficznych dla każdego etapu wdrożenia.

Przed wdrożeniem upewnij się, że docelowa przestrzeń robocza zawiera wskazaną bibliotekę zmiennych i zmienną oraz że aktywny jest właściwy zestaw wartości. Wdrożenie nie zmienia aktywnego zestawu wartości. Jeśli wdrożenie tworzy docelową przestrzeń roboczą, domyślne jest aktywne, dopóki nie wybierzesz i nie zapiszesz innego zestawu wartości.

Dla akcji planu wdrożenia możesz użyć zmiennej referencyjnej jako wartości parametru. Aby uzyskać więcej informacji, zobacz Przekazywanie parametrów do akcji.

Jeśli Fabric nie może rozwiązać odwołania, raportuje, która część odwołania zawiodła. Informacje o kolejności rozwiązywania i poprawkach znajdziesz w Variable reference resolution failures.

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.

Wybór aktywnego zestawu wartości to stan workspace i nie jest przechowywany w Gicie. Podczas początkowej synchronizacji, gdy biblioteka zmiennych jest importowana do nowej przestrzeni roboczej, Default jest aktywne. Jeśli środowisko docelowe wymaga innego zestawu wartości, otwórz bibliotekę importowanych zmiennych w nowym workspace, ustaw wymagany zestaw wartości jako aktywny i zapisz bibliotekę zmiennych przed uruchomieniem elementów zależnych lub działań planu wdrożenia.

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

Zrzut ekranu przedstawiający folder Git z plikami biblioteki zmiennych w nim.

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

  • Ostatnia aktualizacja o