Nota
Prístup na túto stránku vyžaduje autorizáciu. Môžete sa pokúsiť prihlásiť alebo zmeniť adresár.
Prístup na túto stránku vyžaduje autorizáciu. Môžete skúsiť zmeniť adresáre.
Zistite, ako fungujú kanály integrácie a nasadenia systému Git s rozhraním API pre GraphQL v službe Microsoft Fabric. Tento článok vám pomôže pochopiť, ako nastaviť pripojenie k vášmu odkladaciemu priestoru, spravovať rozhranie API pre GraphQL a nasadiť ich v rôznych prostrediach.
Nota
Rozhranie API pre riadenie zdrojov GraphQL a nasadenie je momentálne vo verzii Preview.
Požiadavky
- Musíte mať rozhranie API pre GraphQL v službe Fabric. Ďalšie informácie nájdete vytvorenie rozhrania API pre GraphQL v službe Fabric a pridanie údajov.
Prehľad
Fabric ponúka výkonné nástroje pre CI/CD (priebežnú integráciu a nepretržité nasadenie) a správu životného cyklu vývoja prostredníctvom dvoch hlavných komponentov: integrácie Git (CI) a kanálov nasadenia (CD). Pracovné priestory slúžia ako centrálne súčasti pre fázy synchronizácie Git aj nasadenia.
Integrácia Git (CI): Synchronizuje položky pracovného priestoru (napríklad kód, konfigurácie, rozhrania API) s odkladacími priestormi na riadenie verzií, umožňuje riadenie verzií a sledovanie zmien prostredníctvom Git.
Kanály nasadenia (CD): Umožňuje vytváranie fáz (napríklad vývoj, test, produkcia) s prepojenými pracovnými priestormi. Položky podporované v každej fáze sa automaticky replikujú do nasledujúcich fáz a zmeny v nasadení spúšťača pracovného priestoru v kanáli vydania. Kanál môžete nakonfigurovať tak, aby sa zabezpečilo, že zmeny budú testované a nasadené efektívne v rámci prostredí.
Fabric podporuje rôzne pracovné postupy CI/CD prispôsobené bežným scenárom. Ďalšie podrobnosti nájdete v téme Možnosti pracovných postupov CI/CD v službe Fabric.
Nota
Počas nasadenia sa kopírujú iba metaúdaje; a údaje sa neskopírujú.
Položky z pracovného priestoru sú uložené v priradenom odkladacom priestore Git ako Infraštruktúra ako kód (IaC). Zmeny kódu v odkladacom priestore môžu spustiť nasadenie v kanáloch. Táto metóda umožňuje automatickú replikáciu zmien kódu v rámci fáz na účely testovania a vydania v produkčnom prostredí.
Metódy overovania zdroja údajov
V tejto časti sa dozviete o metódach overovania na pripojenie zdrojov údajov k rozhraniu API pre GraphQL a oboznámte sa s ich vplyvom na automatické priradenie medzi rozhraním API pre GraphQL a pripojenými zdrojmi údajov v kanáloch vývoja. Ďalšie informácie o automatickom priradení v procese kanála nasadenia.
Existujú dve možnosti, ako pripojiť zdroje údajov k vášmu API pre GraphQL:
Pripojenie k zdrojom údajov služby Fabric pomocou overenia jediným prihlásením (SSO)
Pripojenie k zdroju údajov Fabric alebo externým zdrojom údajov pomocou uloženého poverenia
Prvá možnosť Single Sign-On (SSO) povoľuje pripojenia k zdrojom údajov v rámci služby Fabric. V tomto prípade, keď pripojíte zdroj údajov k GraphQL pomocou metódy jediného prihlásenia v pôvodnom pracovnom priestore (napríklad Dev stage), zdroj údajov a položka GraphQL sa nasadí do cieľového pracovného priestoru (napríklad fáza Test) v kanáli a GraphQL v cieľovom pracovnom priestore sa automaticky pripojí k nasadenému lokálnemu zdroju údajov v cieľovom pracovnom priestore (pozri diagram nižšie). Pri používaní jediného prihlásenia a pripájaní k zdroju údajov prostredníctvom koncového bodu SQL Analytics existujú špecifické obmedzenia, ďalšie podrobnosti nájdete v **Aktuálne obmedzenia.
Druhá možnosť Uložené prihlasovacie údaje umožňuje pripojenia k externým zdrojom údajov mimo služby Fabric a zdrojom údajov v rámci služby Fabric. Automatické priradenie však nie je podporované pre prístup Uložené poverenia. To znamená, že ak pripojíte zdroj údajov k GraphQL pomocou uložených poverení v pôvodnom pracovnom priestore (Dev stage), zdroj údajov sa nasadí do cieľového pracovného priestoru (fáza testovania) v kanáli. Položka GraphQL v cieľovom pracovnom priestore však zostane pripojená k zdroju údajov v pôvodnom pracovnom priestore (dev stage) prostredníctvom uložených poverení a nie k automatickému priradeniu k lokálnemu zdroju údajov v cieľovom pracovnom priestore. (pozrite si diagram nižšie)
Okrem toho, ak sa na pripojenie k zdrojom údajov používa metóda Uložené prihlasovacie údaje, vývojári musia mať prístup k uloženým informáciám o poverení, aby mohli úspešne nasadiť položku GraphQL.
Nota
Ak je rozhranie API pre funkciu GraphQL v pôvodnom pracovnom priestore (fáza Dev) pripojené k zdroju údajov, ktorý je v inom pracovnom priestore, nasadenie rozhrania API pre GraphQL v cieľovom pracovnom priestore (fáza testovania) zostane pripojené k zdroju údajov, ktorý sa nachádza v inom pracovnom priestore, bez ohľadu na metódu overenia použitú na pripojenie zdrojov údajov k rozhraniu API pre GraphQL. (pozrite si diagram nižšie)
Rozhranie API pre integráciu Git v jazyku GraphQL
Rozhranie API služby Fabric pre GraphQL ponúka integráciu Git pre ovládanie zdroja. Vďaka integrácii so systémom Git môžete zálohovať a verzie svojho rozhrania API pre GraphQL, vrátiť sa podľa potreby k predchádzajúcim fázam, spolupracovať alebo pracovať samostatne pomocou vetiev Git a spravovať svoje rozhranie API pre životný cyklus GraphQL úplne v rámci služby Fabric.
Nastavenie pripojenia:
V nastaveniach pracovného priestoru môžete jednoducho nastaviť pripojenie k odkladaciemu priestoru na potvrdenie a synchronizáciu zmien. Ak chcete nastaviť pripojenie, pozrite si tému Začíname s integráciou systému Git. Po pripojení sa položky vrátane rozhrania API pre GraphQL zobrazia na ovládacom paneli Zdroj .
Po úspešnom potvrdení rozhrania API pre inštancie GraphQL do odkladacieho priestoru Git sa v odkladacom priestore zobrazí štruktúra priečinkov GraphQL. Teraz môžete vykonávať budúce operácie, ako je napríklad vytvorenie žiadosti o prijatie zmien.
Reprezentácia GraphQL v Git:
Nasledujúci obrázok je príkladom štruktúry súborov každého rozhrania API pre položku GraphQL v odkladacom priestore Git:
Keď potvrdíte rozhranie API pre položku GraphQL do odkladacieho priestoru Git, uloží sa rozhranie API pre definíciu GraphQL. Tento prístup podporuje presné obnovenie pri synchronizácii späť do pracovného priestoru služby Fabric:
Ďalšie informácie o formáte definície, syntaxi a príkladoch rozhrania API GraphQL nájdete v dokumentácii k rozhraniam API riadiacej roviny Fabric:
Rozhranie API pre GraphQL v kanáli nasadenia
Pomocou nasledujúcich krokov dokončite rozhranie API na nasadenie GraphQL pomocou kanála nasadenia.
Vytvorte nový kanál nasadenia alebo otvorte existujúci kanál nasadenia. Ďalšie informácie nájdete v téme Začíname s kanálmi nasadenia.
Priraďte pracovné priestory do rôznych fáz podľa vašich cieľov nasadenia.
Výber, zobrazenie a porovnanie položiek vrátane rozhrania API pre GraphQL medzi rôznymi fázami, ako je znázornené v nasledujúcom príklade. Zvýraznené oblasti označujúce počet zmenených položiek medzi predchádzajúcou a aktuálnou fázou.
- Vyberte položky, ktoré je potrebné nasadiť. Vyberte položku Nasadiť a nasaďte vybraté položky (API pre GraphQL a jeho pripojený zdroj údajov) vo fázach vývoja, testovania a produkcie.
Zobrazí sa ďalšia správa potvrdzujúca položky, ktoré sa chystáte nasadiť. Výberom položky Nasadiť potvrďte a pokračujte v procese nasadenia.
Aktuálne obmedzenia
Fabric CI/CD nepodporuje automatické priradenie podradených položiek. To znamená, že ak sa rozhranie API pre GraphQL pripojí ku koncovému bodu SQL Analytics ako podriadený zdroj údajov v pôvodnom pracovnom priestore (napríklad fáza Dev), pôvod sa neprenesie do cieľového pracovného priestoru (napríklad fáza Testovania). V dôsledku toho nasadzované rozhranie API pre GraphQL v cieľovom pracovnom priestore (napríklad fáza testovania) zostane pripojené ku koncovému bodu SQL Analytics v pôvodnom pracovnom priestore (napríklad fáza vývojára).
Automatické priradenie nie je podporované, keď sa na pripojenia zdroja údajov používa prístup Uložené poverenia . Ďalšie informácie nájdete v časti Metódy overovania zdroja údajov popísanej vyššie.