Del via

Kildekontroll- og distribusjonssamlebånd i API for GraphQL (forhåndsvisning)

Finn ut hvordan Git-integrerings- og distribusjonssamlebånd fungerer med API for GraphQL i Microsoft Fabric. Denne artikkelen hjelper deg med å forstå hvordan du konfigurerer en tilkobling til repositoriet, administrerer API-en for GraphQL og distribuerer dem på tvers av ulike miljøer.

Merk

API for GraphQL-kildekontroll og -distribusjon er for øyeblikket i forhåndsvisning.

Forutsetning

Oversikt

Fabric tilbyr kraftige verktøy for CI/CD (kontinuerlig integrasjon og kontinuerlig distribusjon) og administrasjon av utviklingslivssyklus gjennom to hovedkomponenter: Git-integrasjon (CI) og utrullingssamlebånd (CD). Arbeidsområder fungerer som sentrale komponenter for både Git-synkronisering og distribusjonsfaser.

Git-integrering (CI): Synkroniserer arbeidsområdeelementer (f.eks. kode, konfigurasjoner, API-er) med versjonskontrollrepositorier, aktivering av versjonskontroll og endringssporing via Git.

Utrullingssamlebånd (CD): Aktiverer oppretting av faser (f.eks. utvikling, test, produksjon) med koblede arbeidsområder. Elementer som støttes i hvert trinn, replikeres automatisk til etterfølgende faser, og endringer i en utrulling av arbeidsområdeutløser i et utgivelsesforløp. Du kan konfigurere datasamlebåndet for å sikre at endringer testes og distribueres effektivt på tvers av miljøer.

Fabric støtter ulike CI/CD-arbeidsflyter som er skreddersydd for vanlige scenarioer. Hvis du vil ha mer informasjon, kan du se alternativer for CI/CD-arbeidsflyt i Fabric.

Merk

Bare metadata kopieres under distribusjonen. og dataene kopieres ikke.

Elementer fra arbeidsområdet lagres i det tilknyttede Git-repositoriet som Infrastruktur som kode (IaC). Kodeendringer i repositoriet kan utløse distribusjonen i datasamlebånd. Med denne metoden kan du få kodeendringer automatisk replisert på tvers av faser for test- og produksjonsutgivelsesformål.

Godkjenningsmetoder for datakilde

I denne delen lærer du om godkjenningsmetoder for å koble datakilder til API-en for GraphQL og forstå deres innvirkning på automatisk binding mellom API-en for GraphQL og de tilkoblede datakildene i utviklingssamlebånd. Du kan lære mer om autobinding i prosessen for utrullingssamlebånd.

Det finnes to tilgjengelige alternativer for å koble datakilder til API-en for GraphQL:

  1. Koble til Fabric-datakilder med enkel påloggingsgodkjenning (SSO)

  2. Koble til fabric eller eksterne datakilder ved hjelp av en lagret legitimasjon

    Skjermbilde av alternativer for GraphQL-tilkobling til datakilder.

Det første alternativet, Enkel Sign-On (SSO), aktiverer tilkoblinger til datakilder i Fabric. I dette tilfellet, når du kobler en datakilde til GraphQL ved hjelp av enkel påloggingsmetode i det opprinnelige arbeidsområdet (for eksempel utvikling), distribueres datakilden og GraphQL-elementet til målarbeidsområdet (for eksempel Test fase) i datasamlebåndet, og GraphQL i målarbeidsområdet blir automatisk koblet til den distribuerte lokale datakilden i målarbeidsområdet (se diagrammet nedenfor). Det finnes spesifikke begrensninger når du bruker SSO og kobler til en datakilde via SQL Analytics-endepunkt, for mer informasjon kan du se **Gjeldende begrensninger.

Det andre alternativet, Lagret legitimasjon, aktiverer tilkoblinger til eksterne datakilder utenfor Fabric og datakilder i Fabric. Autobinding støttes imidlertid ikke for fremgangsmåten for lagret legitimasjon. Dette betyr at hvis du kobler en datakilde til GraphQL ved hjelp av lagret legitimasjon i det opprinnelige arbeidsområdet (utviklingsområde), distribueres datakilden til målarbeidsområdet (testfasen) i datasamlebåndet. GraphQL-elementet i målarbeidsområdet forblir imidlertid koblet til datakilden i det opprinnelige arbeidsområdet (Utvikling-fasen) gjennom lagret legitimasjon, i stedet for å automatisk binde til en lokal datakilde i målarbeidsområdet. (se diagrammet nedenfor)

Hvis metoden Lagret legitimasjon brukes til å koble til datakilder, må utviklere i tillegg ha tilgang til informasjonen om lagret legitimasjon for å kunne distribuere GraphQL-elementet.

Merk

Hvis en API for GraphQL i opprinnelig arbeidsområde (utviklingsområde) er koblet til en datakilde som er i et annet arbeidsområde, vil den distribuerte API-en for GraphQL i målarbeidsområdet (testfasen) forbli koblet til datakilden som er plassert i et annet arbeidsområde, uavhengig av hvilken godkjenningsmetode som brukes til å koble datakildene til API-en for GraphQL. (se diagrammet nedenfor)

Skjermbilde av datasamlebånd for ulike datakildetilkoblinger og scenarioer.

API for GraphQL Git-integrasjon

Fabric API for GraphQL tilbyr Git-integrasjon for kildekontroll. Med Git-integrering kan du sikkerhetskopiere og versjonere API-en for GraphQL, gå tilbake til tidligere faser etter behov, samarbeide eller arbeide alene ved hjelp av Git-grener og administrere API-en for GraphQL-livssyklusen helt i Fabric.

Konfigurere en tilkobling:

Fra innstillingene for arbeidsområdet kan du enkelt konfigurere en tilkobling til repo for å utføre og synkronisere endringer. Hvis du vil konfigurere tilkoblingen, kan du se Komme i gang med Git-integrasjon. Når de er tilkoblet, vises elementene, inkludert API for GraphQL, i Kontrollpanel for kilde .

Skjermbilde av status for arbeidsområde og kildekontroll.

Når du har utført API-en for GraphQL-forekomster til Git-repositoriet, ser du graphQL-mappestrukturen i repositoriet. Nå kan du utføre fremtidige operasjoner, for eksempel Opprett pull-forespørsel.

GraphQL-representasjon i Git:

Følgende bilde er et eksempel på filstrukturen for hvert API for GraphQL-element i Git-repositoriet:

Skjermbilde av filstrukturrepresentasjon i Git for GraphQL.

Når du utfører API-en for GraphQL-elementet til Git-repositoriet, lagres API-en for GraphQL-definisjonen. Denne tilnærmingen støtter en nøyaktig gjenoppretting når du synkroniserer tilbake til et stoffarbeidsområde:

Skjermbilde av API for GraphQL-definisjoner lagret i Git.

Du finner mer informasjon om GraphQL API-definisjonsformatet, syntaksen og eksemplene i dokumentasjonen for API-er for strukturkontrollplan:

API for GraphQL i utrullingssamlebånd

Bruk følgende fremgangsmåte for å fullføre API-en for GraphQL-distribusjon ved hjelp av utrullingssamlebåndet.

  1. Opprett et nytt utrullingssamlebånd eller åpne et eksisterende utrullingssamlebånd. Hvis du vil ha mer informasjon, kan du se Komme i gang med utrullingssamlebånd.

  2. Tilordne arbeidsområder til ulike faser i henhold til distribusjonsmålene.

  3. Velg, vis og sammenlign elementer, inkludert API for GraphQL mellom ulike faser, som vist i eksemplet nedenfor. De uthevede områdene som angir antall endrede elementer mellom forrige fase og gjeldende fase.

Skjermbilde av datasamlebånd som illustrerer elementenes status i hvert utviklingstrinn.

  1. Velg elementene som må distribueres. Velg Distribuer for å distribuere de valgte elementene (API for GraphQL og den tilkoblede datakilden) på tvers av utviklings-, test- og produksjonsfasene.

Skjermbilde av datasamlebånd som viser de valgte elementene som må distribueres.

Den neste meldingen dukker opp og bekrefter elementene du er i ferd med å distribuere. Velg Distribuer for å bekrefte og fortsette distribusjonsprosessen.

Skjermbilde av pipeline som viser bekreftelsesmelding for distribusjon.

Gjeldende begrensninger

  1. Fabric CI/CD støtter ikke autobinding av underordnede elementer. Dette betyr at hvis API-en for GraphQL kobler til et SQL Analytics-endepunkt som underordnet en datakilde i det opprinnelige arbeidsområdet (f.eks. utviklingsnivå), overføres ikke avstammingen til målarbeidsområdet (f.eks. testtrinn). Som et resultat forblir den distribuerte API-en for GraphQL i målarbeidsområdet (f.eks. testtrinn) koblet til SQL Analytics-endepunktet i det opprinnelige arbeidsområdet (f.eks. utviklingsnivå).

  2. Autobinding støttes ikke når fremgangsmåten for lagret legitimasjon brukes for datakildetilkoblinger. Hvis du vil ha mer informasjon, kan du se delen om godkjenningsmetoder for datakilder som er beskrevet ovenfor.

Relatert innhold

  • Last updated on