Jaa

Kuormitusten esittely

  • Artikkeli

Tässä luvussa esitellään järjestelmämme keskeiset osat ja annetaan yleiskatsaus arkkitehtuuriin. Nämä komponentit toimivat yhdessä ja luovat vankan ja joustavan ympäristön kehitystarpeisiin. Tutustutaanpa näihin komponentteihin ja niiden rooleihin arkkitehtuurissamme.

Fabric-kuormituksen arkkitehtuuri

Fabric-kuormitusarkkitehtuurin keskeisimpiin näkökohtiin kuuluvat:

  • Se käsittelee tietojen käsittelyä, tallennusta ja hallintaa. Se vahvistaa Microsoft Entra ID -tunnukset ennen niiden käsittelyä ja on vuorovaikutuksessa ulkoisten Azure-palveluiden, kuten Lakehousen, kanssa.

  • Kuormituksen Edusta (FE) tarjoaa käyttöliittymän työpaikkojen luomiseen, tuottamiseen, hallintaan ja suorittamiseen.

  • Käyttäjän vuorovaikutukset FE:n kautta käynnistävät BE:lle pyyntöjä joko suoraan tai epäsuorasti Fabric Backendin (Fabric BE) kautta.

Tarkempia kaavioita, jotka kuvaavat eri osien viestintää ja todentamista, on taustatodentamisen ja -valtuutuksen yleiskatsauksessa ja todentamisen yleiskatsauskaavioissa .

Edusta (FE)

Edusta toimii käyttökokemuksen (UX) pohjana ja toimii iframe-kehyksessä Fabric-portaalissa. Se tarjoaa Fabric-kumppanille erityisen käyttöliittymän, kuten kohdeeditorin. Laajennuksen asiakas-SDK järjestää tarvittavat liittymät, ohjelmointirajapinnat ja bootstrap-funktiot tavallisen verkkosovelluksen muuntamiseksi Micro Frontend -verkkosovellukseksi, joka toimii saumattomasti Fabric-portaalissa.

Tausta (BE)

Tausta on tietojenkäsittelyn ja metatietojen tallennuksen voimalaitos. Se käyttää CRUD-toimintoja kuormituskohteiden ja metatietojen luomiseen ja hallintaan sekä suorittaa töitä tallennustilan tietojen täyttämiseksi. Edustan ja taustan välinen viestintäsilta muodostetaan julkisten ohjelmointirajapintojen kautta.

Kuormituksia voi suorittaa kahdessa ympäristössä: paikallisessa ympäristössä ja pilvipalvelussa. Paikallisesti (devmode) kuormitus suoritetaan kehittäjän tietokoneessa DevGateway-apuohjelman hallitsemien ohjelmointirajapintakutsujen avulla. Tämä apuohjelma käsittelee myös kuormituksen rekisteröinnin Fabricilla. Pilvitilassa kuormitus suoritetaan kumppanipalveluissa, ja ohjelmointirajapintakutsut tehdään suoraan HTTPS-päätepisteeseen.

Kehitysympäristö

  • Kehitystilan kuormituspaketti: Kun luot taustaratkaisua Visual Studiossa, luo Virheenkorjaus-koontimäärityksellä BE NuGet -paketti, joka voidaan ladata Fabric-vuokraajaan DevGateway-sovelluksen avulla.

Kehittäjätilan arkkitehtuurin kaavio.

  • Pilvitilan kuormituspaketti: Kun luot BE-ratkaisua Visual Studiossa, luo erillinen kuormituspaketti (BE ja FE) Julkaisun koontiversio -määrityksen avulla. Tämä paketti voidaan ladata suoraan vuokraajaan.

Pilvitila-arkkitehtuurin kaavio.

Kuormituksen NuGet-paketin rakenne

Kuormitus on pakattu NuGet-pakettina, joka yhdistää tausta- ja edustaosat. Rakenne noudattaa tiettyjä nimeämiskäytäntöjä, ja Fabric valvoo sitä, jotta se on yhdenmukainen kaikissa latausskenaarioita varten. Kuormituksia kuvaava NuGet-paketti on jäsennetty sisältämään sekä taustaosat että edustaosat.

Taustarakenne

Taustasegmentti koostuu tiedostoista.xml jotka määrittävät kuormituksen ja siihen liittyvät kohteet, jotka ovat välttämättömiä Fabric-rekisteröinnille.

Tärkeimmät osat
  • WorkloadManifest.xml - Kuormituksen määritystiedostolla täytyy olla tämä tarkka nimi Fabric-todentamista varten.
  • Item1.xml, Item2.xml, ... - Luettelotiedostot yksittäisille kohteille, joissa on joustava nimeäminen XML-muodon mukaisesti.

Edustarakenne

Edustaosa sisältää .json -tiedostot, joissa on tiedot edustan tuotteesta ja kohteista, sekä kuvakkeiden assets-hakemiston.

Tärkeimmät osat
  • Product.json - Tuotteesi edustan tärkein luettelo, joka on nimettävä tarkasti Fabric-tarkistusta varten.
  • Item1.json, Item2.json, ... - Luettelotiedostoja yksittäisistä kohteista, joissa on joustava nimeäminen JSON-muodon mukaisesti. Kukin json vastaa taustaluetteloa (esimerkiksi Item1.json Item1.xml).
  • assets kansio - Tallentaa kaikki kuvakkeet icon1.jpg, icon2.png, ... joita edusta käyttää.

Pakollinen rakenteen yhteensopivuus

Rakenne, johon sisältyy tietyt alikansioiden nimet ("BE", "FE", "assets"), on Fabricille pakollinen ja pakotettu kaikissa latausskenaariossa, mukaan lukien testi- ja kehityspaketit. Rakenne on määritetty tiedostoissa, .nuspec jotka löytyvät säilöstä hakemiston Backend/src/Packages/manifest alta.

Rajat

Seuraavat rajoitukset koskevat kaikkia NuGet-pakettityyppejä sekä kehitystilassa että pilvitilassa:

  • Vain BE ja FE alikansiot ovat sallittuja. Kaikki muut näiden kansioiden ulkopuolella sijaitsevat alikansiot tai tiedostot aiheuttavat latausvirheen.
  • - BE kansio hyväksyy vain .xml tiedostot. Mikä tahansa muu tiedostotyyppi aiheuttaa latausvirheen.
  • Kohdetiedostoja voi olla enintään 10, mikä tarkoittaa, että BE kansio voi sisältää yhden WorkloadManifest.xml ja enintään 10 Item.xml tiedostoa. Jos kansiossa on yli 10 kohdetiedostoa, tämä aiheuttaa latausvirheen.
  • Alikansion Assets on sijaittava -kansion FE alla. Se voi sisältää enintään 15 tiedostoa, joista jokaisen tiedosto on enintään 1,5 Mt.
  • Alikansiossa Assets on sallittu vain seuraavat tiedostotyypit: .jpeg, .jpg, .png.
  • Kansiossa FE voi olla enintään 10 kohdetiedostoa sekä yksi product.json tiedosto.
  • Jokaiseen kansiossa olevaa Assets resurssiin on viitattava kohdetiedostojen sisällä. Resurssi, johon viitataan kohdetiedostosta, joka puuttuu kansiosta Assets , aiheuttaa latausvirheen.
  • Kohteiden tiedostonimien on oltava yksilöllisiä. Päällekkäiset tiedostonimet aiheuttavat latausvirheen.
  • Tiedostonimien on sisällettävä aakkosnumeerisia (englanninkielisiä) merkkejä tai vain tavuviivoja, eikä niissä saa olla yli 32 merkkiä. Muiden merkkien käyttäminen tai tämän pituuden ylittäminen aiheuttaa latausvirheen.
  • Paketin kokonaiskoko ei saa olla yli 20 Mt.
  • Katso kokoonpanoluettelosta luettelotiedostosta erityiset rajoitukset.

Paikallinen kehitystila (devmode)

Kuormituksen taustapalvelu (BE) toimii kehittäjän tietokoneessa. Kuormituksen API-kutsut siirretään Azure Relayn kautta. Kuormituksen puoli Azure-välityskanavassa on erikoisen DevGateway-komentoriviapuohjelman hallinnoima. Kuormituksen hallinnan API-kutsut lähetetään suoraan kuormituksesta Fabriciin ohittaen Azure Relay -kanavan. DevGateway-apuohjelma valvoo myös kuormituksen paikallisen kehitysesiintymän rekisteröimistä Fabriciin tietyn työtilan yhteydessä. Kun DevGateway-apuohjelma lopetetaan, kuormituksen esiintymän rekisteröinti peruutetaan automaattisesti. Lisätietoja on kohdassa Taustan toteutusopas.

DevMode BE -rakenne

Kehitystilan kaavio on rakennearkkitehtuuri.

Pilvipalvelukehitystila (pilvitila)

Kuormituksen taustapalvelu (BE) toimii kumppanin palveluissa. Kuormituksen API-kutsut tehdään suoraan HTTPS-päätepisteeseen kuormituksen luettelotiedostossa määritetyllä tavalla. Tässä skenaariossa DevGateway-apuohjelmaa ei tarvita. Kuormituksen rekisteröinti Fabriciin toteutetaan lataamalla NuGet-paketti Fabriciin ja aktivoimalla sitten kuormitus vuokraajalle. Lisätietoja on artikkelissa Kuormituksen hallinta Fabricissa.

CloudMode BE -rakenne

Pilvipalvelutilan BE-rakenteen arkkitehtuurin kaavio.

Liittyvä sisältö