Sdílet prostřednictvím

Správa zdrojového kódu a kanály nasazení v rozhraní API pro GraphQL (Preview)

Zjistěte, jak integrace Gitu a kanály nasazení fungují s rozhraním API pro GraphQL v Microsoft Fabric. Tento článek vám pomůže pochopit, jak nastavit připojení k úložišti, spravovat rozhraní API pro GraphQL a nasazovat je v různých prostředích.

Poznámka:

Rozhraní API pro správu zdrojového kódu GraphQL a nasazení je aktuálně ve verzi Preview.

Požadavky

Přehled

Fabric nabízí výkonné nástroje pro CI/CD (kontinuální integrace a průběžné nasazování) a správu životního cyklu vývoje prostřednictvím dvou hlavních komponent: integrace Gitu (CI) a nasazovacích kanálů (CD). Pracovní prostory slouží jako centrální komponenty pro fáze synchronizace Gitu i nasazení.

Integrace Gitu (CI): Synchronizuje položky pracovního prostoru (např. kód, konfigurace, rozhraní API) s úložišti správy verzí, povolení správy verzí a sledování změn prostřednictvím Gitu.

Kanály nasazení (CD): Umožňuje vytváření fází (např. Vývoj, Testování, Produkce) s propojenými pracovními prostory. Položky podporované v každé fázi se automaticky replikují do následných fází a změny v pracovním prostoru spustí nasazení v nasazovacím potrubí. Kanál můžete nakonfigurovat tak, aby se zajistilo, že se změny testují a nasazují efektivně napříč prostředími.

Fabric podporuje různé pracovní postupy CI/CD přizpůsobené běžným scénářům. Další podrobnosti najdete v tématu Možnosti pracovního postupu CI/CD ve Fabricu.

Poznámka:

Během nasazování se zkopírují pouze metadata; a data se nezkopírují.

Položky z pracovního prostoru se ukládají v přidruženém úložišti Git jako infrastruktura jako kód (IaC). Změny kódu v úložišti mohou aktivovat nasazení v potrubích. Tato metoda umožňuje automaticky replikovat změny kódu napříč fázemi pro účely testování a produkční verze.

Metody ověřování zdroje dat

V této části se dozvíte o metodách ověřování pro připojení zdrojů dat k rozhraní API pro GraphQL a pochopení jejich dopadu na automatické vazby mezi rozhraním API pro GraphQL a jejími připojenými zdroji dat ve vývojových kanálech. Další informace o automatickém navázání v procesu kanálu nasazení.

Existují dvě možnosti připojení zdrojů dat k rozhraní API pro GraphQL:

  1. Připojení ke zdrojům dat Fabric pomocí jednotného přihlašování (SSO)

  2. Připojení k systému Fabric NEBO externím zdrojům dat pomocí uložených pověření.

    Snímek obrazovky s možnostmi připojení GraphQL ke zdrojům dat

První možnost, Single Sign-On (SSO), umožňuje připojení ke zdrojům dat v rámci Fabric. Když v tomto případě připojíte zdroj dat k GraphQL pomocí metody jednotného přihlašování v původním pracovním prostoru (například ve vývojové fázi), budou zdroj dat a položka GraphQL nasazeny do cílového pracovního prostoru (například v testovací fázi) v rámci pipeline, a GraphQL v cílovém pracovním prostoru se automaticky připojí k nasazenému místnímu zdroji dat v cílovém pracovním prostoru (viz diagram níže). Při používání jednotného přihlašování a při připojování ke zdroji dat prostřednictvím koncového bodu SQL Analytics platí určitá omezení. Další podrobnosti najdete v tématu **Aktuální omezení.

Druhá možnost Uložené přihlašovací údaje umožňuje připojení k externím zdrojům dat mimo Fabric a zdroje dat v rámci Fabric. Automatické vazby se ale u uloženého přístupu s přihlašovacími údaji nepodporují. To znamená, že pokud připojíte zdroj dat k GraphQL pomocí uloženého přihlašovacího údaje v původním pracovním prostoru (fáze Dev), zdroj dat bude nasazen do cílového pracovního prostoru (fáze Test) v rámci pipeline. Položka GraphQL v cílovém pracovním prostoru však zůstane připojená ke zdroji dat v původní fázi pracovního prostoru (fáze vývoje) prostřednictvím uložených přihlašovacích údajů, a ne automatické vazby k místnímu zdroji dat v cílovém pracovním prostoru. (viz následující diagram)

Pokud se navíc k připojení ke zdrojům dat používá metoda Saved Credential , musí vývojáři mít přístup k uloženým informacím o přihlašovacích údajích, aby mohli úspěšně nasadit položku GraphQL.

Poznámka:

Pokud je rozhraní API pro GraphQL v původním pracovním prostoru (vývojové fázi) připojené ke zdroji dat, který je v jiném pracovním prostoru, zůstane nasazené rozhraní API pro GraphQL v cílovém pracovním prostoru (fáze testování) připojené ke zdroji dat, který se nachází v jiném pracovním prostoru bez ohledu na to, jakou metodu ověřování se používá k připojení zdrojů dat k rozhraní API pro GraphQL. (viz následující diagram)

Snímek obrazovky datové linky pro různá připojení k datovým zdrojům a scénáře.

Integrace rozhraní API pro GraphQL Git

Rozhraní API fabric pro GraphQL nabízí integraci Gitu pro správu zdrojového kódu. S integrací Gitu můžete zálohovat a spravovat vaše rozhraní API pro GraphQL, podle potřeby se vrátit k předchozím fázím, spolupracovat nebo pracovat samostatně pomocí větví Git a spravovat vaše rozhraní API pro životní cyklus GraphQL zcela v rámci fabric.

Nastavení připojení:

V nastavení pracovního prostoru můžete snadno nastavit připojení k úložišti pro potvrzení a synchronizaci změn. Informace o nastavení připojení najdete v tématu Začínáme s integrací Gitu. Po připojení se položky, včetně rozhraní API pro GraphQL, zobrazí na panelu Správa zdrojového kódu .

Snímek obrazovky pracovního prostoru a stavu správy zdrojového kódu

Po úspěšném potvrzení rozhraní API pro instance GraphQL do úložiště Git se v úložišti zobrazí struktura složek GraphQL. Teď můžete spouštět budoucí operace, jako je vytvoření žádosti o přijetí změn.

Reprezentace GraphQL v Gitu:

Následující obrázek je příkladem struktury souborů jednotlivých rozhraní API pro položku GraphQL v úložišti Git:

Snímek obrazovky s reprezentací struktury souborů v Gitu pro GraphQL

Když potvrdíte položku rozhraní API pro GraphQL do úložiště Git, uloží se definice rozhraní API pro GraphQL. Tento přístup podporuje přesné obnovení při synchronizaci zpět do pracovního prostoru Fabric:

Snímek obrazovky s definicemi rozhraní API pro GraphQL uloženými v Gitu

Další informace o formátu definice rozhraní GraphQL API, syntaxi a příkladech najdete v dokumentaci k rozhraním API řídicí roviny infrastruktury:

Rozhraní API pro GraphQL v procesu nasazení

Pomocí následujících kroků dokončete nasazení rozhraní API pro GraphQL pomocí kanálu nasazení.

  1. Vytvořte nový kanál nasazení nebo otevřete existující kanál nasazení. Další informace najdete v tématu Začínáme s kanály nasazení.

  2. Přiřaďte pracovní prostory k různým fázím podle cílů nasazení.

  3. Vyberte, zobrazte a porovnejte položky včetně rozhraní API pro GraphQL mezi různými fázemi, jak je znázorněno v následujícím příkladu. Zvýrazněné oblasti označující změněný počet položek mezi předchozí a aktuální fází.

Snímek obrazovky pipeline znázorňující stav položek v každé fázi vývoje

  1. Vyberte položky, které je potřeba nasadit. Výběrem Nasadit nasadíte vybrané položky (rozhraní API pro GraphQL a jeho připojený zdroj dat) ve fázích vývoj, testování a produkce.

Snímek obrazovky pipeline znázorňující položky, které je potřeba nasadit.

Další zpráva se zobrazí s potvrzením položek, které se chystáte nasadit. Výběrem Nasadit potvrďte a pokračujte v procesu nasazení.

Snímek obrazovky pipeline zobrazující potvrzovací zprávu o nasazení.

Aktuální omezení

  1. CI/CD Fabric nepodporuje automatické propojení podřízených položek. To znamená, že pokud se rozhraní API pro GraphQL připojí ke koncovému bodu SQL Analytics jako podřízený zdroj dat v původním pracovním prostoru (např. fáze vývoje), rodokmen se nepřenese do cílového pracovního prostoru (např. testovací fáze). V důsledku toho zůstane nasazené rozhraní API pro GraphQL v cílovém pracovním prostoru (např. testovací fáze) připojené ke koncovému bodu SQL Analytics v původním pracovním prostoru (např. fáze vývoje).

  2. Automatické vazby se nepodporují, pokud se pro připojení ke zdroji dat používá přístup Uložené přihlašovací údaje . Další informace najdete v části Metody ověřování zdroje dat popsané výše.

Související obsah

  • Last updated on