Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Bruk variabelbiblioteker i Fabric for å administrere konfigurasjoner på tvers av stadier i release-pipelinen og for å lagre verdier i Git. Denne artikkelen forklarer hvordan du bruker variabelbiblioteker i sammenheng med livssyklusadministrasjon og kontinuerlig integrasjon og kontinuerlig levering (CI/CD).
Variable biblioteker og utrullingssamlebånd
Du kan distribuere variabelbiblioteker og deres verdier i utrullingssamlebånd for å administrere variable verdier på tvers av faser.
Husk denne viktige informasjonen:
Alle verdisett i variabelbiblioteket er tilgjengelige for alle faser i utrullingssamlebåndet, men bare ett sett er aktivt i en fase.
Den aktive verdien som er angitt for hvert trinn, velges uavhengig. Du kan endre det når som helst.
Når et variabelbibliotek distribueres til et tomt stadium, oppretter distribusjonen et arbeidsområde hvor standardverdisettet er aktivt. Hvis målmiljøet krever et annet verdisett, åpne variabelbiblioteket i målarbeidsområdet, sett det nødvendige verdisettet som aktivt, og lagre variabelbiblioteket før du kjører avhengige elementer eller distribusjonsplanhandlinger.
Selv om distribusjoner ikke påvirker det valgte aktive verdisettet i hver fase, kan du oppdatere selve verdiene i variabelbiblioteket. Forbrukerelementet i arbeidsområdet (for eksempel et datasamlebånd) mottar automatisk den riktige verdien fra det aktive verdisettet.
Følgende operasjoner til variabler eller verdisett i én fase av et utrullingssamlebånd fører til at variabelbiblioteket gjenspeiles som en annen skjemakildesammenlignet med det samme elementet i en annen fase:
- Variabler som er lagt til, slettet eller redigert
- Verdisett som er lagt til eller slettet
- Navn på variabler
- Rekkefølge på variabler
En enkel endring i det aktive verdisettet registreres ikke som Annen skjemakilde når du sammenligner. Det aktive verdisettet er en del av varekonfigurasjonen, men det er ikke inkludert i definisjonen. Derfor vises den ikke i sammenligningen av distribusjonspipelinen og ikke overskrives for hver distribusjon.
Bruk variabelbiblioteksverdier i en distribusjonsplan
En deployeringsplan-handling kan bruke en variabelbibliotekreferanse i stedet for en literal parameterverdi. Når distribusjonen kjører, løser Fabric referansen ved å bruke det aktive verdisettet til variabelbiblioteket i målarbeidsområdet. Dette gjør at samme handling kan bruke verdier som er spesifikke for hvert utrullingsstadium.
Før du deployerer, sørg for at målarbeidsområdet inneholder det refererte variabelbiblioteket og variabelen, og at riktig verdisett er aktivt. Distribusjonen endrer ikke det aktive verdisettet. Hvis distribusjonen oppretter målarbeidsområdet, er Standard aktiv til du velger og lagrer et annet verdisett.
For en deployeringsplan-handling kan du bruke en variabelreferanse som verdien av en parameter. For mer informasjon, se Pass parametere til en handling.
Hvis Fabric ikke kan løse en referanse, rapporterer den hvilken del av referansen som feilet. For oppløsningssekvensen og fiksene, se Variabel referanseoppløsningsfeil.
Variabelbiblioteker og Git-integrasjon
I likhet med andre Fabric-elementer kan variable biblioteker integreres med Git for kildekontroll. Variable bibliotekelementer lagres som mapper som du kan vedlikeholde og synkronisere mellom Fabric og Git-leverandøren.
Elementtillatelser kontrolleres under Git-oppdatering og -forpliktelse.
Valget av aktivt verdisett er arbeidsområdets tilstand og lagres ikke i Git. Når innledende synkronisering importerer et variabelbibliotek til et nytt arbeidsområde, er Standard aktiv. Hvis målmiljøet krever et nytt verdisett, åpne det importerte variabelbiblioteket i det nye arbeidsområdet, sett det nødvendige verdisettet som aktivt, og lagre variabelbiblioteket før du kjører avhengige elementer eller distribusjonsplanhandlinger.
Skjemaet for variabelbibliotekelementet er et JSON-objekt som inneholder fire deler:
- Mappe for verdisett
- Innstillinger
- Platform.json, en automatisk generert fil
- Variabler
Verdisett
Mappen med variabelt bibliotek inneholder en undermappe kalt valueSets. Denne mappen inneholder en JSON-fil for hvert verdisett. Denne JSON-filen inneholder bare variabelverdiene for verdier som ikke er standard , i verdisettet.
For mer informasjon om verdisettfilen, se verdisett og eksempelet med verdisettet.
Verdier for variabler som ikke er i denne filen, hentes fra standardverdisettet.
Innstillinger
Filen settings.json inneholder innstillinger for variabelbiblioteket.
For mer informasjon, se variabler og detsettings.json eksempelet.
Variabler
Filen variables.json inneholder variabelnavnene og standardverdiene deres.
Hvis du vil ha mer informasjon, kan du se eksempletvariables.json.
Hensyn og begrensninger
Begrensninger for variabler
Det kan være opptil 1 000 variabler og opptil 1 000 verdisett, så lenge du oppfyller begge disse kravene:
- Det totale antallet celler i de alternative verdisettene er mindre enn 10 000.
- Varens størrelse overskrider ikke 1 MB.
Disse kravene valideres når du lagrer endringer.
Notatfeltet kan ha opptil 2 048 tegn.
Beskrivelsesfeltet for verdisettet kan ha opptil 2 048 tegn.
Begrensninger for alternative verdisett
- Alternative verdisett i et variabelbibliotek vises i den rekkefølgen du la dem til. For øyeblikket kan du ikke endre rekkefølgen på dem i brukergrensesnittet. Hvis du vil endre rekkefølgen, redigerer du JSON-filen direkte.
- Navnet på hvert verdisett må være unikt i et variabelbibliotek.
- Variabelnavn må være unike i et variabelbibliotek. Du kan ha to variabler med samme navn i et arbeidsområde hvis de er i forskjellige elementer.
- Det er alltid én (og bare én) aktiv verdi angitt i et variabelbibliotek om gangen. Du kan ikke slette et verdisett mens det er aktivt. Hvis du vil slette den, må du først konfigurere en annen verdi som er satt til å være aktiv. Du kan ha en annen aktiv verdi angitt for hver fase i et utrullingssamlebånd.