CI/CD för variabelbibliotek

Du kan använda Microsoft Fabric-variabelbibliotek för att hantera konfigurationer i olika steg i versionspipelinen och för att spara värden i Git. Den här artikeln beskriver hur du använder variabelbibliotek i samband med livscykelhantering och kontinuerlig integrering och kontinuerlig leverans (CI/CD).

Variabelbibliotek och distributionspipelines

Du kan distribuera variabelbibliotek och deras värden i distributionspipelines för att hantera variabelvärden mellan olika faser.

Kom ihåg den här viktiga informationen:

• Alla värdeuppsättningar i variabelbiblioteket är tillgängliga för alla faser i distributionspipelinen, men endast en uppsättning är aktiv i en fas.

• Den aktiva värdeuppsättningen för varje fas väljs oberoende av varandra. Du kan ändra det när som helst.

• När du först distribuerar eller checkar in ett variabelbibliotek har bibliotekets aktiva uppsättning standardvärdet. Du kan ändra det här värdet genom att komma åt det nyligen skapade variabelbiblioteket i målfasen eller lagringsplatsen och ändra den aktiva uppsättningen.

  

• Även om distributioner inte påverkar det valda aktiva värdet som anges i varje steg kan du uppdatera själva värdena i variabelbiblioteket. Konsumentobjektet på arbetsytan (till exempel en pipeline) tar automatiskt emot rätt värde från den aktiva värdeuppsättningen.

Följande åtgärder för variabler eller värdeuppsättningar i en fas i en distributionspipeline gör att variabelbiblioteket återspeglas som en annan formulärkällajämfört med samma objekt i en annan fas:

• Variabler har lagts till, tagits bort eller redigerats
• Värdeuppsättningar har lagts till eller tagits bort
• Namn på variabler
• Ordningen på variabler

En enkel ändring av den aktiva värdeuppsättningen registreras inte som annan formulärkälla när du jämför. Den aktiva värdeuppsättningen är en del av objektkonfigurationen, men den ingår inte i definitionen. Därför visas den inte i jämförelsen av distributionspipelinen och skrivs inte över för varje distribution.

Variabelbibliotek och Git-integrering

Precis som andra infrastrukturobjekt kan variabelbibliotek integreras med Git för källkontroll. Objekt för variabelbibliotek lagras som mappar som du kan underhålla och synkronisera mellan Fabric och git-providern.

Objektbehörigheter kontrolleras under Git-uppdatering och incheckning.

Schemat för variabelbiblioteksobjektet är ett JSON-objekt som innehåller fyra delar:

• Mapp för värdeuppsättningar
• Inställningar
• Platform.json, en automatiskt genererad fil
• Variabler

Värdeuppsättningar

Mappen variabelbibliotek innehåller en undermapp med namnet valueSets. Den här mappen innehåller en JSON-fil för varje värdeuppsättning. Den här JSON-filen innehåller endast variabelvärdena för värden som inte är standard i den värdeuppsättningen.

Mer information om värdeuppsättningsfilen finns i exemplet med värdeuppsättningen.

Värden för variabler som inte finns i den här filen hämtas från standardvärdeuppsättningen.

Inställningar

Filen settings.json innehåller inställningar för variabelbiblioteket.

Mer information finns i settings.json exempel.

Variabler

Filen variables.json innehåller variabelnamnen och deras standardvärden.

Mer information finns i variables.json exempel.

Överväganden och begränsningar

Storleksgränser

• Det kan finnas upp till 1 000 variabler och upp till 1 000 värdeuppsättningar, så länge du uppfyller båda dessa krav:

  • Det totala antalet celler i de alternativa värdeuppsättningarna är mindre än 10 000.
  • Objektets storlek överskrider inte 1 MB.

  Dessa krav verifieras när du sparar ändringar.

• Anteckningsfältet kan innehålla upp till 2 048 tecken.

• Beskrivningsfältet för värdemängd kan ha upp till 2 048 tecken.

Begränsningar för alternativa värdeuppsättningar

• Alternativa värdeuppsättningar i ett variabelbibliotek visas i den ordning som du lade till dem. För närvarande kan du inte ändra ordning på dem i användargränssnittet. För att ändra ordningen, redigera JSON-filen direkt.
• Namnet på varje värdeuppsättning måste vara unikt i ett variabelbibliotek.
• Variabelnamn måste vara unika i ett variabelbibliotek. Du kan ha två variabler med samma namn på en arbetsyta om de finns i olika objekt.
• Det finns alltid ett (och bara ett) aktivt värde som anges i ett variabelbibliotek i taget. Du kan inte ta bort en värdeuppsättning när den är aktiv. Om du vill ta bort det konfigurerar du först ett annat värde som ska vara aktivt. Du kan ha olika aktiva värden för varje steg i en distributionspipeline.

Relaterat innehåll

• Git-integreringens källkodsformat