Not
Å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.
Lär dig hur Git-integrerings- och distributionspipelines fungerar med API för GraphQL i Microsoft Fabric. Den här artikeln hjälper dig att förstå hur du konfigurerar en anslutning till din lagringsplats, hanterar ditt API för GraphQL och distribuerar dem i olika miljöer.
Anmärkning
API för GraphQL-källkontroll och -distribution är för närvarande i förhandsversion.
Förutsättningar
- Du måste ha ett API för GraphQL i Fabric. Mer information finns i Skapa ett API för GraphQL i Fabric och lägg till data.
Översikt
Fabric erbjuder kraftfulla verktyg för CI/CD (kontinuerlig integrering och kontinuerlig distribution) och livscykelhantering för utveckling via två huvudkomponenter: Git-integrering (CI) och distributionspipelines (CD). Arbetsytor fungerar som centrala komponenter för både Git-synkronisering och distributionssteg.
Git-integrering (CI): Synkroniserar arbetsyteobjekt (t.ex. kod, konfigurationer, API:er) med lagringsplatser för versionskontroll, vilket aktiverar versionskontroll och ändringsspårning via Git.
Distributionspipelines (CD): Gör det möjligt att skapa faser (t.ex. utveckling, test, produktion) med länkade arbetsytor. Objekt som stöds i varje steg replikeras automatiskt till efterföljande steg och ändringar i en distribution av arbetsytans utlösare i en versionspipeline. Du kan konfigurera pipelinen för att säkerställa att ändringar testas och distribueras effektivt i olika miljöer.
Fabric har stöd för olika CI/CD-arbetsflöden som är skräddarsydda för vanliga scenarier. Mer information finns i alternativ för CI/CD-arbetsflöde i Fabric.
Anmärkning
Endast metadata kopieras under distributionen. och data kopieras inte.
Objekt från arbetsytan lagras i den associerade Git-lagringsplatsen som Infrastruktur som kod (IaC). Kodändringar på lagringsplatsen kan utlösa distributionen i pipelines. Med den här metoden kan du få kodändringar automatiskt replikerade i olika faser i test- och produktionsversionssyfte.
Autentiseringsmetoder för datakälla
I det här avsnittet får du lära dig mer om autentiseringsmetoder för att ansluta datakällor till ditt API för GraphQL och förstå deras inverkan på automatiskbindning mellan API:et för GraphQL och dess anslutna datakällor i utvecklingspipelines. Du kan lära dig mer om automatisk bindning i distributionspipelineprocessen.
Det finns två tillgängliga alternativ för att ansluta datakällor till ditt API för GraphQL:
Ansluta till Infrastrukturdatakällor med enkel inloggningsautentisering (SSO)
Ansluta till infrastrukturresurser eller externa datakällor med hjälp av en sparad autentiseringsuppgift
Det första alternativet, Enkel Sign-On (SSO), aktiverar anslutningar till datakällor inom Fabric. I det här fallet när du ansluter en datakälla till GraphQL med metoden enkel inloggning på den ursprungliga arbetsytan (till exempel Dev-fasen) distribueras datakällan och GraphQL-objektet till målarbetsytan (till exempel teststeg) i pipelinen och GraphQL på målarbetsytan ansluts automatiskt till den distribuerade lokala datakällan på målarbetsytan (se diagrammet nedan). Det finns specifika begränsningar när du använder enkel inloggning och ansluter till en datakälla via SQL Analytics-slutpunkten. Mer information finns i **Aktuella begränsningar.
Det andra alternativet, Sparade autentiseringsuppgifter, möjliggör anslutningar till externa datakällor utanför Infrastrukturresurser och datakällor i Infrastrukturresurser. Automatisk bindning stöds dock inte för metoden Sparad autentiseringsuppgift. Det innebär att om du ansluter en datakälla till GraphQL med hjälp av sparade autentiseringsuppgifter i den ursprungliga arbetsytan (Dev-fasen) distribueras datakällan till målarbetsytan (teststeget) i pipelinen. GraphQL-objektet på målarbetsytan förblir dock anslutet till datakällan i den ursprungliga arbetsytan (Utvecklingssteg) via sparade autentiseringsuppgifter i stället för att automatiskt binda till en lokal datakälla på målarbetsytan. (se diagrammet nedan)
Om metoden Sparad autentiseringsuppgift används för att ansluta till datakällor måste utvecklare dessutom ha åtkomst till informationen om sparade autentiseringsuppgifter för att kunna distribuera GraphQL-objektet.
Anmärkning
Om ett API för GraphQL i den ursprungliga arbetsytan (Utvecklingssteg) är anslutet till en datakälla som finns på en annan arbetsyta förblir det distribuerade API:et för GraphQL på målarbetsytan (teststeg) anslutet till datakällan som finns på en annan arbetsyta oavsett vilken autentiseringsmetod som används för att ansluta datakällorna till api:et för GraphQL. (se diagrammet nedan)
API för GraphQL Git-integrering
Infrastruktur-API för GraphQL erbjuder Git-integrering för källkontroll. Med Git-integrering kan du säkerhetskopiera och version ditt API för GraphQL, återgå till tidigare steg efter behov, samarbeta eller arbeta ensam med Git-grenar och hantera api:et för GraphQL-livscykeln helt i Fabric.
Konfigurera en anslutning:
Från inställningarna för arbetsytan kan du enkelt konfigurera en anslutning till lagringsplatsen för att checka in och synkronisera ändringar. Information om hur du konfigurerar anslutningen finns i Kom igång med Git-integrering. När du är ansluten visas dina objekt, inklusive API för GraphQL, på kontrollpanelen Källa .
När du har checkat in API:et för GraphQL-instanser till Git-lagringsplatsen visas GraphQL-mappstrukturen på lagringsplatsen. Du kan nu köra framtida åtgärder, till exempel Skapa pull-begäran.
GraphQL-representation i Git:
Följande bild är ett exempel på filstrukturen för varje API för GraphQL-objekt i Git-lagringsplatsen:
När du checkar in API:et för GraphQL-objektet i Git-repo lagras GraphQL-API-definitionen. Den här metoden stöder en exakt återställning när du synkroniserar tillbaka till en Fabric-arbetsyta.
Du hittar mer information om GraphQL API-definitionsformatet, syntaxen och exemplen i dokumentationen om API:er för kontrollplanet i Infrastruktur:
API för GraphQL i distributionsprocessen
Följ stegen nedan för att slutföra API:et för GraphQL-distributionen med hjälp av distributionspipelinen.
Skapa en ny distributionspipeline eller öppna en befintlig distributionspipeline. Mer information finns i Komma igång med distributionspipelines.
Tilldela arbetsytor till olika faser enligt dina distributionsmål.
Välj, visa och jämför objekt, inklusive API för GraphQL mellan olika faser, som du ser i följande exempel. De markerade områdena som anger ändrat antal objekt mellan föregående fas och aktuell fas.
- Välj de objekt som ska distribueras. Välj Distribuera för att distribuera valda objekt (API för GraphQL och dess anslutna datakälla) i utvecklings-, test- och produktionsfaserna.
Nästa meddelande visas som bekräftar de objekt som du ska distribuera. Välj Distribuera för att bekräfta och fortsätta distributionsprocessen.
Aktuella begränsningar
Fabric CI/CD stöder inte automatiskt bindning av underordnade objekt. Det innebär att om API:et för GraphQL ansluter till en SQL Analytics-slutpunkt som en underkomponent till en datakälla i den ursprungliga arbetsytan (t.ex. utvecklingsfas) överförs inte ursprunget till målarbetsytan (t.ex. testfas). Därför förblir det distribuerade API:et för GraphQL på målarbetsytan (t.ex. teststeg) anslutet till SQL Analytics-slutpunkten på den ursprungliga arbetsytan (t.ex. Dev-fasen).
Automatisk bindning stöds inte när metoden Sparade autentiseringsuppgifter används för datakällans anslutningar. Mer information finns i avsnittet om autentiseringsmetoder för datakällor som beskrivs ovan.