Megosztás a következőn keresztül:

Forrásvezérlési és üzembehelyezési folyamatok a GraphQL API-ban (előzetes verzió)

Megtudhatja, hogyan működnek a Git integrációs és üzembehelyezési folyamatai a GraphQL API-val a Microsoft Fabricben. Ez a cikk segít megérteni, hogyan állíthat be kapcsolatot az adattárral, hogyan kezelheti a GraphQL API-t, és hogyan helyezheti üzembe őket különböző környezetekben.

Megjegyzés:

A GraphQL-forrásvezérléshez és -üzembe helyezéshez készült API jelenleg előzetes verzióban érhető el.

Előfeltételek

Áttekintés

A Fabric hatékony eszközöket kínál a CI/CD -hez (folyamatos integráció és folyamatos üzembe helyezés) és a fejlesztési életciklus-felügyelethez két fő összetevőn keresztül: a Git-integráció (CI) és az üzembehelyezési folyamatok (CD). A munkaterületek központi összetevőkként szolgálnak a Git szinkronizálási és üzembe helyezési fázisaihoz.

Git-integráció (CI):Szinkronizálja a munkaterület elemeit (például kódokat, konfigurációkat, API-kat) a verziókövetési adattárakkal, lehetővé téve a verziókövetést és a változáskövetést a Giten keresztül.

Üzembehelyezési folyamatok (CD):: Lehetővé teszi szakaszok (például fejlesztés, tesztelés, éles üzem) létrehozását csatolt munkaterületekkel. Az egyes fázisokban támogatott elemek automatikusan replikálódnak a következő szakaszokba, és a munkaterület módosításai aktiválják a kiadási folyamat üzembe helyezését. A folyamatot úgy konfigurálhatja, hogy a módosítások tesztelése és üzembe helyezése hatékonyan történjen a környezetekben.

A Fabric különböző, a gyakori forgatókönyvekhez szabott CI-/CD-munkafolyamatokat támogat. További részletekért tekintse meg a CI/CD munkafolyamat-beállításait a Fabricben.

Megjegyzés:

Csak a metaadatok másolása történik az üzembe helyezés során; és az adatok nem lesznek másolva.

A munkaterület elemei a társított Git-adattárban vannak tárolva infrastruktúra mint kód (IaC) néven. A kódtár kódmódosításai elindíthatják az üzembe helyezést a csővezetékekben. Ez a módszer lehetővé teszi, hogy a kódmódosítások automatikusan replikálódjanak a különböző szakaszokban tesztelési és éles kiadási célokra.

Adatforrás-hitelesítési módszerek

Ebben a szakaszban megismerheti azokat a hitelesítési módszereket, amellyel adatforrásokat csatlakoztathat az API for GraphQL-hez, és megismerheti azok hatását a GraphQL API és a csatlakoztatott adatforrások közötti automatikus kötésre a fejlesztési folyamatokban. Az automatikus kötésről az üzembehelyezési folyamat folyamatában tudhat meg többet.

Két lehetőség áll rendelkezésre az adatforrások GraphQL-hez készült API-hoz való csatlakoztatására:

  1. Csatlakozás Fabric-adatforrásokhoz egyszeri bejelentkezéses hitelesítéssel (SSO)

  2. Csatlakozás Fabric vagy külső adatforrásokhoz mentett hitelesítő adatokkal

    Képernyőkép az adatforrásokhoz való GraphQL-kapcsolat beállításairól.

Az első lehetőség, a Single Sign-On (SSO) lehetővé teszi a Fabricen belüli adatforrásokhoz való kapcsolódást. Ebben az esetben, ha egy adatforrást a GraphQL-hez csatlakoztat az eredeti munkaterület egyszeri bejelentkezési módszerével (például fejlesztői fázis), az adatforrás és a GraphQL-elem a folyamat cél-munkaterületére (például tesztelési szakasz) lesz üzembe helyezve, és a cél-munkaterület GraphQL-jének automatikusan csatlakozik a cél-munkaterületen üzembe helyezett helyi adatforráshoz (lásd az alábbi ábrát). Az egyszeri bejelentkezés használatakor és az SQL Analytics-végponton keresztüli adatforráshoz való csatlakozáskor bizonyos korlátozások vonatkoznak, további részletekért tekintse meg a **Jelenlegi korlátozások című témakört.

A második lehetőség, a Saved Credential, lehetővé teszi a kapcsolódást a Fabricen kívüli és a Fabricen belüli adatforrásokhoz. A mentett hitelesítő adatok megközelítése azonban nem támogatja az automatikus kötést . Ez azt jelenti, hogy ha egy adatforrást a GraphQL-hez az eredeti munkaterületen (fejlesztői fázisban) mentett hitelesítő adatokkal csatlakoztat, az adatforrás a folyamat cél-munkaterületén (tesztszakasz) lesz üzembe helyezve. A cél-munkaterület GraphQL-eleme azonban továbbra is az eredeti munkaterület (fejlesztési fázis) adatforrásához csatlakozik a mentett hitelesítő adatokon keresztül, ahelyett, hogy a cél-munkaterületen lévő helyi adatforráshoz csatlakozna. (lásd az alábbi ábrát)

Emellett ha a Mentett hitelesítő adatok metódust használják az adatforrásokhoz való csatlakozáshoz, a fejlesztőknek hozzáféréssel kell rendelkezniük a mentett hitelesítő adatokhoz a GraphQL-elem sikeres üzembe helyezéséhez.

Megjegyzés:

Ha az eredeti munkaterületen (fejlesztői fázisban) lévő GraphQL API egy másik munkaterületen található adatforráshoz csatlakozik, a cél munkaterületen (tesztelési fázisban) a GraphQL-hez telepített API továbbra is csatlakozik a különböző munkaterületen található adatforráshoz, függetlenül attól, hogy melyik hitelesítési módszerrel csatlakoztatja az adatforrásokat a GraphQL API-hoz. (lásd az alábbi ábrát)

Képernyőkép a különböző adatforrás-kapcsolatok és forgatókönyvek folyamatáról.

API a GraphQL Git-integrációhoz

A GraphQL-hez készült Fabric API Git-integrációt kínál a forrásvezérléshez. A Git-integrációval biztonsági másolatot készíthet az API-ról a GraphQL-hez, szükség szerint visszatérhet a korábbi szakaszokhoz, együttműködhet vagy önállóan dolgozhat a Git-ágak használatával, és teljes mértékben kezelheti a GraphQL-életciklushoz készült API-t a Fabricen belül.

Kapcsolat beállítása:

A munkaterület beállításai között egyszerűen állíthat be kapcsolatot az adattárral a módosítások véglegesítéséhez és szinkronizálásához. A kapcsolat beállításához tekintse meg a Git-integráció első lépéseit. A csatlakozás után az elemek, beleértve a GraphQL API-t is, megjelennek a Forrás vezérlőpulton .

Képernyőkép a munkaterület és a forrásvezérlő állapotáról.

Miután sikeresen véglegesíti a GraphQL-példányok API-ját a Git-adattárban, megjelenik a GraphQL mappastruktúra az adattárban. Most már végrehajthatja a jövőbeli műveleteket, például lekéréses kérelem létrehozását.

GraphQL-ábrázolás a Gitben:

Az alábbi kép egy példa a Git-adattárban lévő GraphQL-elemekhez tartozó API-k fájlstruktúrájára:

Képernyőkép a GraphQL-hez készült Git fájlstruktúra-ábrázolásáról.

Amikor véglegesíti az API for GraphQL-elemet a Git-adattárban, a GraphQL-definíció API-ja tárolódik. Ez a módszer támogatja a pontos helyreállítást, amikor visszaszinkronizálja egy Szövet-munkaterületre:

Képernyőkép a Gitben tárolt GraphQL-definíciókHOZ készült API-ról.

A GraphQL API definíciós formátumáról, szintaxisáról és példáiról a Fabric vezérlősík API-k dokumentációjában talál további információt:

API a GraphQL-hez az üzembehelyezési folyamatban

Az alábbi lépésekkel fejezheti be az API-t a GraphQL üzembe helyezéséhez az üzembe helyezési folyamat használatával.

  1. Hozzon létre új telepítési folyamatot, vagy nyissa meg a meglévő telepítési folyamatot. További információért lásd: Bevezetés az üzembe helyezési folyamatokhoz.

  2. Munkaterületek hozzárendelése különböző szakaszokhoz az üzembe helyezési céloknak megfelelően.

  3. Válassza ki, tekintse meg és hasonlítsa össze az elemeket, beleértve a GraphQL API-t a különböző szakaszok között, ahogyan az alábbi példában is látható. A kiemelt területek, amelyek az előző szakasz és az aktuális szakasz között módosított elemek számát jelzik.

Képernyőkép az egyes fejlesztési fázisokban az elemek állapotát szemléltető folyamatról.

  1. Jelölje ki az üzembe helyezendő elemeket. Válassza az Üzembe helyezés lehetőséget a kijelölt elemek (a GraphQL API és a csatlakoztatott adatforrás) üzembe helyezéséhez a fejlesztési, tesztelési és éles fázisokban.

Képernyőkép a folyamatról, amelyen az üzembe helyezendő kijelölt elemek láthatók.

Ekkor megjelenik a következő üzenet, amely megerősíti az üzembe helyezni kívánt elemeket. Az üzembe helyezési folyamat megerősítéséhez és folytatásához válassza az Üzembe helyezés lehetőséget.

Képernyőkép a folyamatról, amelyen az üzembe helyezést megerősítő üzenet látható.

Jelenlegi korlátozások

  1. A Fabric CI/CD nem támogatja a gyermekelemek autokötését. Ez azt jelenti, hogy ha a GraphQL API egy SQL-elemzési végponthoz csatlakozik egy adatforrás alá tartozó elemként az eredeti munkaterületen (például a fejlesztési szakaszban), akkor a származás nem kerül át a cél munkaterületre (például a tesztszakaszra). Ennek eredményeképpen a GraphQL-hez telepített API a cél-munkaterületen (pl. tesztelési fázis) az eredeti munkaterületEN (pl. fejlesztői fázis) csatlakozik az SQL Analytics-végponthoz.

  2. Az automatikus kötés nem támogatott, ha a Mentett hitelesítő adatok módszert használják adatforrás-kapcsolatokhoz. További információkért tekintse meg az adatforrás-hitelesítési módszerek fent leírt szakaszát.

Kapcsolódó tartalom

  • Last updated on