Zdieľať cez

Úvodné informácie o vyťaženiach (Preview)

  • Článok

Táto kapitola predstavuje kľúčové komponenty nášho systému a poskytuje prehľad o architektúre. Tieto komponenty sa navzájom spolupracujú a vytvárajú robustnú a flexibilnú platformu pre vaše potreby v oblasti vývoja. Prejdime na tieto súčasti a ich roly v rámci našej architektúry.

Architektúra vyťaženia služby Fabric

Medzi kľúčové aspekty architektúry vyťaženia služby Fabric patria:

  • Spracováva spracovanie, ukladanie a správu údajov. Pred ich spracovaním overuje tokeny Microsoft Entra ID a komunikuje s externými službami Azure, ako je napríklad Lakehouse.

  • Klientske vyťaženie (FE) ponúka používateľské rozhranie na vytváranie pracovných miest, vytváranie, spravovanie a spúšťanie.

  • Interakcie používateľov prostredníctvom FE iniciujú požiadavky na službu BE, či už priamo alebo nepriamo prostredníctvom koncového serveru služby Fabric (Fabric BE).

Podrobnejšie diagramy znázorňujúce komunikáciu a overovanie jednotlivých komponentov nájdete v téme Backend authentication and authorization overview (Serverové overovanie a prehľad overenia) a Diagramy prehľadu overovania.

Klientske rozhranie (FE)

Klientske rozhranie slúži ako základ používateľského prostredia (UX) a správania, ktoré sa nachádza v rámci objektu iframe na portáli služby Fabric. Partnerovi služby Fabric poskytuje konkrétne používateľské rozhranie vrátane editora položiek. Rozšírenie klienta SDK vybaví potrebné rozhrania, API a funkcie bootstrap pre transformáciu bežnej webovej aplikácie do micro klientskej webovej aplikácie, ktorá bezproblémovo funguje na portáli fabric.

Koncový server (BE)

Koncový server je moceň pre spracovanie údajov a ukladanie metaúdajov. Používa operácie CRUD na vytváranie a spravovanie položiek vyťaženia spolu s metaúdajmi a spúšťa úlohy na vyplnenie údajov v úložisku. Komunikačný most medzi klientskym a koncovým serverom vzniká prostredníctvom verejných rozhraní API.

Vyťaženia sa môžu spúšťať v dvoch prostrediach: lokálne a v cloude. V lokálnom prostredí (devmode) sa vyťaženie spúšťa v počítači vývojára s volaniami rozhrania API spravovanými pomôckou DevGateway. Tento nástroj tiež spracováva registráciu vyťaženia pomocou služby Fabric. V cloudovom režime sa vyťaženie spustí v partnerských službách s volaniami API priamo do koncového bodu HTTPS.

Vývojové prostredie

  • Balík vyťaženia v režime dev: Pri vytváraní riešenia back-end vo Visual Studiu vytvorte pomocou konfigurácie zostáv Ladenie balíka BE NuGet, ktorý možno načítať do nájomníka služby Fabric pomocou aplikácie DevGateway.

Diagram architektúry režimu vývojára.

  • Balík vyťaženia v cloudovom režime: Pri vytváraní riešenia BE vo Visual Studiu vytvorte samostatný balík vyťaženia (BE a FE) pomocou konfigurácie release build. Tento balík je možné nahrať priamo do nájomníka.

Diagram architektúry cloudového režimu.

Štruktúra balíka Workload NuGet

Vyťaženie je zbalené ako balík NuGet, ktorý kombinuje serverové a klientske súčasti. Štruktúra dodržiava konkrétne konvencie pomenovania a je vynucovaná službou Fabric z dôvodu konzistentnosti v rámci scenárov nahrávania. Balík NuGet, ktorý predstavuje vyťaženia, je štruktúrovaný tak, aby zahŕňal serverové aj klientske súčasti.

Serverová štruktúra

Koncový segment pozostáva zo súborov .xml, ktoré definujú vyťaženie a jej súvisiace položky, ktoré sú nevyhnutné na registráciu v službe Fabric.

Kľúčové súčasti
  • WorkloadManifest.xml – Konfiguračný súbor vyťaženia musí mať tento presný názov na overenie služby Fabric.
  • Item1.xml, , Item2.xml... – manifesty pre jednotlivé položky s flexibilným pomenovaním v súlade s formátom XML.

Klientska štruktúra

Klientska sekcia obsahuje .json súbory s podrobnosťami o produkte a položkách na klientskom paneli spolu s adresárom položiek pre ikony.

Kľúčové súčasti
  • Product.json – hlavný manifest pre klientsky produkt, ktorý musí byť presne pomenovaný na overenie služby Fabric.
  • Item1.json, , Item2.json... – manifesty pre jednotlivé položky s flexibilným pomenovaním v súlade s formátom JSON. Každý kód json zodpovedá koncovému manifestu (napr. Item1.json Item1.xml).
  • assets folder – ukladá všetky ikony icon1.jpg, icon2.png, ... používané klientskou bránou.

Povinné dodržiavanie štruktúry

Štruktúra vrátane konkrétnych názvov podpriečinkov ("BE", "FE", "assets") je povinná a vynútená službou Fabric pre všetky scenáre nahrávania vrátane testovacích a vývojových balíkov. Štruktúra je špecifikovaná v súboroch.nuspec, ktoré sa nachádzajú v odkladacom priestore pod adresárom Backend/src/Packages/manifest .

Limity

Nasledujúce limity sa vzťahujú na všetky typy balíkov NuGet, a to ako v režime vývoja, tak aj v cloudovom režime:

  • Povolené sú iba BE podpriečinky a FE podpriečinky. Akékoľvek iné podpriečinky alebo súbory umiestnené mimo týchto priečinkov majú za následok chybu pri nahrávaní.
  • Priečinok BE prijíma iba .xml súbory. Akýkoľvek iný typ súboru má za následok chybu nahrávania.
  • Povolených je maximálne 10 súborov položiek, čo znamená, že BE priečinok môže obsahovať jeden WorkloadManifest.xml až 10 Item.xml súborov. Ak je v priečinku viac ako 10 súborov položiek, výsledkom je chyba nahrávania.
  • Podpriečinok sa Assets musí nachádzať v priečinku FE . Môže obsahovať až 15 súborov, pričom každý súbor nie je väčší ako 1,5 MB.
  • V podpriečinku Assets sú povolené iba tieto typy súborov: .jpeg, .jpg, .png.
  • Priečinok FE môže obsahovať maximálne 10 súborov položiek plus jeden product.json súbor.
  • Na každú položku v priečinku Assets sa musí odkazovať v súboroch položiek. Akékoľvek položky, na ktoré sa odkazuje zo súboru položky, ktorý v priečinku Assets chýba, budú mať za následok chybu pri nahrávaní.
  • Názvy súborov položiek musia byť jedinečné. Duplicitné názvy súborov majú za následok chybu nahrávania.
  • Názvy súborov musia obsahovať alfanumerické (anglické) znaky alebo spojovníky iba a nemôžu presiahnuť dĺžku 32 znakov. Pri použití iných znakov alebo prekračujúcich túto dĺžku sa vyskytne chyba nahrávania.
  • Celková veľkosť balíka nesmie presiahnuť 20 MB.
  • Konkrétne obmedzenia nájdete v manifeste vyťaženia.

Režim lokálneho vývoja (devmode)

Koncový server vyťaženia (BE) funguje v počítači vývojára. Volania rozhrania API vyťaženia sa prenášajú prostredníctvom služby Azure Relay, pričom vyťaženie je na strane kanála Azure Relay spravovaného špecializovaným nástrojom príkazového riadka DevGateway. Volania rozhrania API ovládacích prvkov vyťaženia sa odosielajú priamo z vyťaženia do služby Fabric, čím sa obchádza kanál služby Azure Relay. Nástroj DevGateway tiež dohliada na registráciu lokálnej vývojovej inštancie vyťaženia služby Fabric v rámci konkrétnej kapacity. Tým sa zabezpečí dostupnosť vyťaženia vo všetkých pracovných priestoroch priradených k danej kapacite. Po ukončení pomôcky DevGateway sa registrácia inštancie vyťaženia automaticky zruší. Ďalšie informácie nájdete v téme Sprievodca klientskou implementáciou.

Schéma DevMode BE

Diagram vývojárového režimu má byť architektúrou schémy.

Režim vývoja v cloude (cloudový režim)

Koncový server vyťaženia (BE) funguje v rámci služieb partnera. Volania rozhrania API vyťaženia sa vykonávajú priamo do koncového bodu HTTPS, ako je to uvedené v manifeste vyťaženia. V tomto scenári nie je pomôcka DevGateway potrebná. Registrácia vyťaženia v službe Fabric sa vykonáva nahratím balíka NuGet pre vyťaženie do služby Fabric a následným aktiváciou vyťaženia pre nájomníka. Ďalšie informácie nájdete v téme Spravovanie vyťaženia v službe Fabric.

Schéma CloudMode BE

Diagram architektúry be cloudového režimu.

Súvisiaci obsah