Konfigurer Git-integration for din Fabric-app

Git-integration hjælper dig med at holde din Fabric-apps deployable definition i versionskontrol. Forbind arbejdsområdet, der indeholder din app, til en depot-gren. Derefter skal du committere ændringer i arbejdsområdet til Git eller anvende ændringer fra Git til arbejdsområdet.

Denne artikel viser dig, hvordan du konfigurerer forbindelsen, forstår app-filerne, der er skrevet til repositoryet, og holder arbejdsområdet og Git synkroniseret.

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

  • Et arbejdsområde med Fabric-kapacitet, der indeholder en implementeret Fabric-app.
  • Workspace-administratorrollen. Git-integration er en indstilling på arbejdsområdeniveau, og kun en workspace-administrator kan forbinde den til et repository.
  • Git-integration aktiveret for din organisation. Gennemgå Fabric- og Git-forudsætningerne.
  • En Azure DevOps-organisation, projekt og arkiv med tilladelse til at oprette en branch og gennemføre ændringer.

Trinene i denne artikel bruger Azure DevOps. GitHub understøttes også. For GitHub-forbindelsesinstruktioner, se Kom i gang med Git-integration.

Forbind dit arbejdsområde til Git

Opsæt Git-integration for hele arbejdsområdet, ikke for en individuel app. Forbindelsen inkluderer andre understøttede elementer i arbejdsområdet.

  1. Åbn det arbejdsområde, der indeholder din app, og vælg Arbejdsområdeindstillinger.

  2. Vælg Git integration i venstre rude.

  3. Vælg Azure DevOps som Git-udbyder.

  4. Vælg en eksisterende konto, eller vælg Tilføj konto og autoriser adgang. Vælg Opret forbindelse.

  5. Konfigurer repositorieforbindelsen:

    Indstilling Hvad skal man vælge
    Organisation Den Azure DevOps-organisation, der indeholder dit repository.
    Project Projektet, der indeholder dit repository.
    Git-arkiv Det repository, hvor du vil gemme app-definitionen.
    Afdeling Vælg + Ny gren for at isolere dit arbejde, eller vælg en eksisterende gren.
    Mappe Indtast et mappenavn for at bruge en eksisterende mappe eller oprette en. Lad dette være tomt for at gemme elementer i arkivets rod.
  6. Vælg Opret forbindelse, og synkroniser.

Hvis den tilsluttede Git-mappe er tom, committerer den første synkronisering de understøttede arbejdsområdeelementer, inklusive din app-definition, til Git. Når synkroniseringen er afsluttet, viser arbejdsområdet den tilsluttede gren og en Git-statuskolonne . Din apps status er Synkroniseret , når arbejdsområdedefinitionen matcher den tilsluttede Git-version. Åbn arkivet i Azure DevOps for at se den genererede appmappe og filer.

Fabric-appstruktur i Git

Følgende eksempel viser filerne i en eksporteret app-definition. Fabric-itemtypen er AppBackend. Eksporten inkluderer kun filer for valgfrie tjenester, når du konfigurerer disse tjenester og implementerer eller anvender deres indhold.

<ItemName>.<ItemType>\
    connectors\
        <connectorName>\
            dab-config.json
    data\
        dab-config.json
    frontend\
        static-app.zip
    functions\
        functions-app.zip
        deploymetadata.json
    storage\
        storage-config.json
    .fabric-app-metadata.json
    .platform
    rayfin.yml
Fil eller mappe Hvad den indeholder Sådan administrerer du den
connectors\<connectorName>\dab-config.json Data API-konfiguration for en connectors eksponerede enheder. Hold connectorens navn i overensstemmelse med dets deklaration, og gennemgå refererede arbejdsområde- og element-ID'er for målmiljøet.
data\dab-config.json Data API-konfiguration og databaseskema for brugerdefinerede enheder. Bevar genererede skemaudvidelser, og gennemgå skemaændringer før implementering.
frontend\static-app.zip De byggede frontend-assets, ikke frontend-kildeprojektet. Genopbyg fra kilden. Medtag denne pakke, når du importerer en definition med statisk hosting aktiveret.
functions\functions-app.zip Funktionsapplikationsudrulningspakken. Genbyg fra kilden, og inkluder det sammen med deploymetadata.json.
functions\deploymetadata.json Det genererede funktionsimplementeringsmanifest. Bevar denne fil og behold den parret med functions-app.zip.
storage\storage-config.json Definitioner af lagringsmapper og adgangsregler. Bevar genererede regler og feltdefinitioner. Uploadede objekter er ikke inkluderet.
.fabric-app-metadata.json App-genereret pakkeversionsinformation, når den optages. Denne fil er ikke nødvendig for import. Bevar denne fil, når du opdaterer en eksporteret definition.
.platform Fabric-elementmetadata og det logiske ID, der bruges af Git-integration. Bevar de genererede metadata og det logiske ID.
rayfin.yml Runtime-servicekonfiguration, connectordeklarationer og hemmelige navne uden hemmelige værdier. For konfigurationsdetaljer, se Fabric Apps projektstruktur.

Behold navnet på det genererede elementmappe, når du redigerer app-konfigurationen, og ændr ikke det logiske ID i .platform. Fabric bruger dette ID til at knytte definitionen i Git til arbejdsområdeelementet. For mere information, se Git-integrationens kildekodeformat.

Note

Det eksporterede rayfin.yml repræsenterer runtime-konfiguration, ikke en kopi af det lokale projekts rayfin/rayfin.yml. Eksport rekonstruerer ikke de lokale stier, byggekommandoer eller udviklingsindstillinger. For den lokale konfiguration, se Fabric Apps-projektstruktur.

Data- og connectorkonfiguration

Filen data\dab-config.json beskriver din apps enheder, API-tilladelser og databaseskema. Det udelukker kildemiljøets dataforbindelsesindstillinger og platformadministrerede enheder såsom Users. Målet konfigurerer sin egen datatjeneste; databaserækker kopieres ikke.

Hver konfigureret GraphQL-understøttet connector kan have sin egen connectors\<connectorName>\dab-config.json fil, hvor <connectorName> dens venlige navn er , såsom adventureWorksSql. En connector-deklaration uden konfiguration af den persisterede entitet indeholder muligvis ikke denne fil. Anvend connectorkonfigurationen på kilden før eksport, hvis du forventer konfigurerede enheder. For connector-opsætning, se Connect Fabric Apps to Fabric data.

Advarsel

Import anvender databaseskemaændringer på målet. Fjernelse eller ændring af enheder eller felter kan være destruktiv. Gennemgå ændringer før implementering; definitionen er ikke en databasebackup.

Lagringskonfiguration

Filen storage\storage-config.json definerer lagringsmapper og deres adgangsregler, ikke de objekter, der uploades til dem. Både data- og lagringstjenesterne skal være aktiveret for at anvende denne konfiguration.

Frontend- og funktionspakker

ZIP-filerne indeholder deployable builds, ikke løse kildefiler. Hold den oprindelige applikationskilde under versionskontrol, så du kan gennemgå kodeændringer og genopbygge pakkerne.

Frontend-eksport udelukker miljøspecifikke rayfin.config.json filer og config.json filer. Import gengenererer runtime-konfigurationen for målet. Hvis statisk hosting er aktiveret, men kilden ikke har nogen frontend-pakke, skal frontend implementeres, før eksport.

Funktionseksport fjerner local.settings.json filer. Giv functions-app.zip og deploymetadata.json sammen ved import, og bevar det genererede manifest. Hvis der ikke er oprettet nogen funktionsapplikation på kildekoden, kan begge filer være fraværende.

Gennemgå konfigurationsfiler og pakket indhold, før du committerer. Inkluder ikke legitimationsoplysninger eller andre hemmeligheder.

Vigtig

Definitionen overfører ikke databaserækker, uploadede lagringsobjekter, brugerkonti eller hemmelige værdier. Det er ikke en backup af din apps data.

Synkroniser ændringer mellem Fabric og Git

Ændringer i arbejdsområdet og ændringer i Git synkroniseres ikke automatisk efter den første forbindelse. Brug Kildekode til at indføre ændringer i arbejdsområdet eller anvende indkommende Git-ændringer.

Vigtig

Git gemmer hemmelige navne, ikke værdier. Efter at have importeret en app eller nye hemmelige navne fra Git, skal du indstille værdierne i målappen. Eksisterende målhemmelighedsværdier bevares.

Udfør ændringer i arbejdsområdet i Git

  1. Opdater og udrul din app til det tilsluttede arbejdsområde, for eksempel ved at bruge Rayfin-CLI'en.
  2. I arbejdsområdet skal du markere kolonnen Git-status . Appen viser uforpligtede ændringer, når dens definition ændres.
  3. Åbn Kildekode-kontrol, og vælg Ændringer.
  4. Gennemgå og vælg appen og eventuelle andre elementer, du har til hensigt at forpligte dig.
  5. Indtast en commit-meddelelse, og vælg Commit.

Efter commit er gennemført, vises de valgte elementer Synkroniseret.

Brug med implementeringspipelines

Git-integrationsversioner af din app-definition. For at fremme denne definition mellem udviklings-, test- og produktionsarbejdsområder, brug implementeringspipelines. Gennemgå miljøspecifikke connectorindstillinger før implementering, og bekræft appen i målarbejdsområdet bagefter.

Vigtig

Implementeringspipelines kopierer hemmelige navne, ikke værdier. Indstil værdierne i hvert måltrin efter den første implementering og hver gang du implementerer nytilføjede hemmeligheder.

Eksisterende hemmelige værdier i målappen bevares. Gennemgå også connector-workspace- og item-ID'er samt eventuelle absolutte autentificerings-omdirigerings-URI'er for målmiljøet; kopiering af en definition garanterer ikke, at eksterne afhængigheder bliver ommappet.

Automatiser med offentlige API'er

For scriptede workflows kan du bruge Hent elementdefinition til at eksportere app-definitionen, Opret element med type AppBackend for at oprette en app ud fra en definition, eller Opdater elementdefinition for at anvende en definition på et eksisterende app-element.

I API-forespørgsler bruger InlineBase64 definitionsdele payloads. Koder YAML og JSON som UTF-8 før Base64-kodning, og koder ZIP-filer fra deres binære bytes.

Disse API'er arbejder på elementdefinitionen. De opretter ikke Git-committs, synkroniserer ikke en branch eller kører en deployment-pipeline. Gennemgå hvert API's forespørgselsformat, tilladelser og langvarige driftshåndtering, før det bruges i automation.