Variable-Bibliothek CI/CD

Sie können Microsoft Fabric-Variablenbibliotheken verwenden, um Konfigurationen über Phasen der Releasepipeline hinweg zu verwalten und Werte in Git zu speichern. In diesem Artikel wird erläutert, wie Variablenbibliotheken im Kontext von Lebenszyklusverwaltung und fortlaufender Integration und fortlaufender Übermittlung (CI/CD) verwendet werden.

Variablenbibliotheken und Bereitstellungspipelines

Sie können Variablebibliotheken und deren Werte in Bereitstellungspipelinen bereitstellen, um Variablenwerte über Phasen hinweg zu verwalten.

Beachten Sie diese wichtigen Informationen:

• Alle Wertesätze in der Variablenbibliothek sind für alle Phasen der Bereitstellungspipeline verfügbar, aber nur ein Satz ist in einer Phase aktiv.

• Der für jede Phase festgelegte aktive Wert wird unabhängig voneinander ausgewählt. Sie können sie jederzeit ändern.

• Wenn Sie eine Variablebibliothek zum ersten Mal bereitstellen oder übernehmen, weist der aktive Satz der Bibliothek den Standardwert auf. Sie können diesen Wert ändern, indem Sie auf die neu erstellte Variablenbibliothek in der Zielphase oder im Repository zugreifen und den aktiven Satz ändern.

  

• Obwohl Bereitstellungen sich nicht auf den ausgewählten aktiven Wert auswirken, der in jeder Phase festgelegt ist, können Sie die Werte selbst in der Variablenbibliothek aktualisieren. Das Verbrauchselement in seinem Arbeitsbereich (z. B. eine Pipeline) empfängt automatisch den richtigen Wert vom aktiven Wertsatz.

Die folgenden Vorgänge für Variablen oder Wertsätze in einer Phase einer Bereitstellungspipeline führen dazu, dass die Variable-Bibliothek im Vergleich zumselben Element in einer anderen Phase als unterschiedliche Formularquelle widerzuspiegeln ist:

• Hinzugefügte, gelöschte oder bearbeitete Variablen
• Hinzugefügte oder gelöschte Wertsätze
• Namen von Variablen
• Reihenfolge der Variablen

Eine einfache Änderung des aktiven Wertsatzes wird beim Vergleichen nicht als unterschiedliche Formularquelle registriert. Der aktive Wertsatz ist Teil der Elementkonfiguration, ist jedoch nicht in der Definition enthalten. Aus diesem Grund wird sie nicht im Vergleich zur Bereitstellungspipeline angezeigt und wird für jede Bereitstellung nicht überschrieben.

Variablenbibliotheken und Git-Integration

Wie andere Fabric-Elemente können Variablenbibliotheken in Git für die Quellcodeverwaltung integriert werden. Variable Bibliothekselemente werden als Ordner gespeichert, die Sie zwischen Fabric und Ihrem Git-Anbieter verwalten und synchronisieren können.

Elementberechtigungen werden während des Git-Updates überprüft und commit ausgeführt.

Das Schema für das Variablenbibliothekselement ist ein JSON-Objekt, das vier Teile enthält:

• Ordner für Wertsätze
• Einstellungen
• Platform.json, eine automatisch generierte Datei
• Variablen

Wertsätze

Der Ordner der Variablenbibliothek enthält einen Unterordner mit dem Namen valueSets. Dieser Ordner enthält eine JSON-Datei für jeden Wertsatz. Diese JSON-Datei enthält nur die Variablenwerte für nicht standardmäßige Werte in diesem Wertsatz.

Weitere Informationen zur Wertsatzdatei finden Sie im Beispiel für den Wertsatz.

Werte für Variablen, die nicht in dieser Datei enthalten sind, werden aus dem Standardwertsatz entnommen.

Einstellungen

Die settings.json Datei enthält Einstellungen für die Variablebibliothek.

Weitere Informationen finden Sie im settings.json Beispiel.

Variablen

Die variables.json Datei enthält die Variablennamen und deren Standardwerte.

Weitere Informationen finden Sie im variables.json Beispiel.

Überlegungen und Einschränkungen

Größeneinschränkungen

• Es können bis zu 1.000 Variablen und bis zu 1.000 Wertesätze vorhanden sein, sofern Sie beide Anforderungen erfüllen:

  • Die Gesamtanzahl der Zellen in den alternativen Wertsätzen ist kleiner als 10.000.
  • Die Größe des Elements überschreitet nicht 1 MB.

  Diese Anforderungen werden überprüft, wenn Sie Änderungen speichern.

• Das Hinweisfeld kann bis zu 2.048 Zeichen enthalten.

• Das Feld mit der Wertsatzbeschreibung kann bis zu 2.048 Zeichen enthalten.

Einschränkungen für alternative Wertesätze

• Alternative Wertesätze in einer Variablenbibliothek werden in der Reihenfolge angezeigt, in der Sie sie hinzugefügt haben. Derzeit können Sie sie nicht in der Benutzeroberfläche neu anordnen. Um die Reihenfolge zu ändern, bearbeiten Sie die JSON-Datei direkt.
• Der Name der einzelnen Wertesätze muss innerhalb einer Variablenbibliothek eindeutig sein.
• Variablennamen müssen innerhalb einer Variablenbibliothek eindeutig sein. Sie können zwei Variablen mit demselben Namen in einem Arbeitsbereich haben, wenn sie sich in verschiedenen Elementen befinden.
• Es gibt immer einen (und nur einen) aktiven Wert, der in einer Variablenbibliothek gleichzeitig festgelegt ist. Sie können einen Wertsatz nicht löschen, während er aktiv ist. Um ihn zu löschen, konfigurieren Sie zuerst einen anderen Wert, der als aktiv festgelegt ist. Sie können für jede Phase einer Bereitstellungspipeline einen anderen aktiven Wert festlegen.

Verwandte Inhalte

• Git-Integration im Quellcodeformat