Variabele bibliotheek CI/CD

U kunt Variabelenbibliotheken van Microsoft Fabric gebruiken om configuraties te beheren in verschillende fasen van de release-pijplijn en om waarden op te slaan in Git. In dit artikel wordt uitgelegd hoe u variabelenbibliotheken gebruikt in de context van levenscyclusbeheer en continue integratie en continue levering (CI/CD).

Variabele bibliotheken en implementatiepijplijnen

U kunt variabelebibliotheken en de bijbehorende waarden implementeren in implementatiepijplijnen om variabelewaarden in fasen te beheren.

Onthoud deze belangrijke informatie:

• Alle waardesets in de variabelebibliotheek zijn beschikbaar voor alle fasen van de implementatiepijplijn, maar er is slechts één set actief in een fase.

• De actieve waarde die voor elke fase is ingesteld, wordt onafhankelijk geselecteerd. U kunt het op elk gewenst moment wijzigen.

• Wanneer u een variabelebibliotheek voor het eerst implementeert of doorvoert, heeft de actieve set van de bibliotheek de standaardwaarde. U kunt deze waarde wijzigen door toegang te krijgen tot de zojuist gemaakte variabelebibliotheek in de doelfase of opslagplaats en de actieve set te wijzigen.

  

• Hoewel implementaties geen invloed hebben op de geselecteerde actieve waarde die in elke fase is ingesteld, kunt u de waarden zelf bijwerken in de variabelebibliotheek. Het verbruiksartikel in de werkruimte (bijvoorbeeld een pijplijn) ontvangt automatisch de juiste waarde van de actief ingestelde waardeset.

De volgende bewerkingen voor variabelen of waardesets in één fase van een implementatiepijplijn zorgen ervoor dat de variabelebibliotheek wordt weergegeven als een andere formulierbronin vergelijking met hetzelfde item in een andere fase:

• Variabelen toegevoegd, verwijderd of bewerkt
• Toegevoegde of verwijderde waardesets
• Namen van variabelen
• Volgorde van variabelen

Een eenvoudige wijziging in de actieve-waardeset wordt niet geregistreerd als een andere formulierbron wanneer u vergelijkt. De actieve-waardeset maakt deel uit van de itemconfiguratie, maar is niet opgenomen in de definitie. Daarom wordt deze niet weergegeven in de vergelijking van de implementatiepijplijn en wordt deze niet overschreven voor elke implementatie.

Bibliotheken voor variabelen en Git-integratie

Net als andere Fabric-items kunnen variabelenbibliotheken worden geïntegreerd met Git voor broncodebeheer. Variabele bibliotheekitems worden opgeslagen als mappen die u kunt onderhouden en synchroniseren tussen Fabric en uw Git-provider.

Itemmachtigingen worden gecontroleerd tijdens het bijwerken en doorvoeren van Git.

Het schema voor het item van de variabele bibliotheek is een JSON-object dat vier delen bevat:

• Map voor waardesets
• Instellingen
• Platform.json, een automatisch gegenereerd bestand
• Variabelen

Waardesets

De map met de variabelebibliotheek bevat een submap met de naam valueSets. Deze map bevat een JSON-bestand voor elke waardeset. Dit JSON-bestand bevat alleen de variabelewaarden voor niet-standaardwaarden in die waardeset.

Zie het voorbeeld van de waardeset voor meer informatie over het waardesetbestand.

Waarden voor variabelen die niet in dit bestand voorkomen, worden opgehaald uit de standaardwaardeset.

Instellingen

Het settings.json bestand bevat instellingen voor de variabelebibliotheek.

Zie het settings.json voorbeeld voor meer informatie.

Variabelen

Het variables.json bestand bevat de namen van de variabelen en de standaardwaarden.

Zie het variables.json voorbeeld voor meer informatie.

Overwegingen en beperkingen

Groottebeperkingen

• Er kunnen maximaal 1000 variabelen en maximaal 1000 waardensets zijn, zolang u aan beide vereisten voldoet:

  • Het totale aantal cellen in de alternatieve waardesets is kleiner dan 10.000.
  • De grootte van het item is niet groter dan 1 MB.

  Deze vereisten worden gevalideerd wanneer u wijzigingen opslaat.

• Het notitieveld mag maximaal 2048 tekens bevatten.

• Het beschrijvingsveld van de waardeset mag maximaal 2048 tekens bevatten.

Beperkingen voor alternatieve waardesets

• Alternatieve waardesets in een variabelebibliotheek worden weergegeven in de volgorde waarin u ze hebt toegevoegd. Op dit moment kunt u ze niet opnieuw ordenen in de gebruikersinterface. Als u de volgorde wilt wijzigen, bewerkt u het JSON-bestand rechtstreeks.
• De naam van elke waardeset moet uniek zijn binnen een variabelebibliotheek.
• Namen van variabelen moeten uniek zijn binnen een variabelebibliotheek. U kunt twee variabelen met dezelfde naam in een werkruimte hebben als ze zich in verschillende items bevinden.
• Er is altijd één (en slechts één) actieve waarde ingesteld in een variabelebibliotheek tegelijk. U kunt een waardeset niet verwijderen terwijl deze actief is. Als u deze wilt verwijderen, configureert u eerst een andere waarde die is ingesteld op actief. U kunt voor elke fase van een implementatiepijplijn een andere actieve waarde instellen.

Verwante inhoud

• Broncode-indeling voor Git-integratie