Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Använd variabelbibliotek i Fabric för att hantera konfigurationer över steg i releasepipelinen 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 ett variabelbibliotek distribueras till ett tomt steg skapar distributionen en arbetsyta där Standardvärdeuppsättningen är aktiv. Om målmiljön kräver en annan värdeuppsättning, öppna variabelbiblioteket i målarbetsytan, sätt den nödvändiga värdeuppsättningen som aktiv och spara variabelbiblioteket innan du kör beroende objekt eller driftplansåtgärder.
Ä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.
Använd variabelbiblioteksvärden i en distributionsplan
En åtgärd för distributionsplanen kan använda en variabelbiblioteksreferens istället för ett bokstavligt parametervärde. När distributionen körs löser Fabric referensen genom att använda den aktiva värdeuppsättningen i variabelbiblioteket i målarbetsytan. Detta gör att samma åtgärd kan använda värden som är specifika för varje utrullningssteg.
Innan du distribuerar, se till att målarbetsytan innehåller det refererade variabelbiblioteket och variabeln, samt att rätt värdeuppsättning är aktiv. Utplaceringen ändrar inte den aktiva värdeuppsättningen. Om distributionen skapar målarbetsytan är Standard aktiv tills du väljer och sparar en annan värdeuppsättning.
För en åtgärd i en distributionsplan kan du använda en variabelreferens som värde på en parameter. För mer information, se Passa parametrar till en åtgärd.
Om Fabric inte kan lösa en referens, rapporterar den vilken del av referensen som misslyckades. För upplösningssekvensen och åtgärderna, se Fel vid upplösning av variabelreferenser.
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.
Valet av aktiv värdemängd ingår i arbetsytans tillstånd och sparas inte i Git. När initial synkronisering importerar ett variabelbibliotek till en ny arbetsyta är Standard aktiv. Om målmiljön kräver en ny värdeuppsättning, öppna det importerade variabelbiblioteket i den nya arbetsytan, sätt den nödvändiga värdeuppsättningen som aktiv och spara variabelbiblioteket innan du kör beroende objekt eller driftsättningsplansåtgärder.
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 värdeuppsättningar och värdeuppsättningsexemplet.
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 variabler och 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
Begränsningar för variabler
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.