Pika-aloitus: Kuormitusmallin suorittaminen
Tässä pikaoppaassa kerrotaan, miten voit luoda ja suorittaa Microsoft Fabric -kuormituksen mallikuormituksen avulla.
Edellytykset
Varmista ennen aloittamista, että järjestelmääsi on asennettu seuraavat:
- Fabric-vuokraajan käyttöoikeus, jossa kuormitusominaisuus ja kehittäjätila ovat käytössä. Lisätietoja on artikkelissa Kuormitusten esittely.
- Node.js.
- npm.
- .NET 6.0:n suorituspalvelu.
- ASP.NET Core Runtime 6.0.
- Visual Studio 2022.
- Fabric-kuormituksen DevGateway
Vaiheittainen opas
Mukautettujen kuormitusten ottaminen käyttöön
Määritä hallintaportaali seuraavasti:
Siirry Asetukset-kohdasta hallintaportaaliin.
Ota Lisää kuormituksia -osiossa käyttöön kapasiteetin järjestelmänvalvojat ja osallistujat voivat lisätä ja poistaa vuokraajan lisäasetuksia. Voit ottaa sen käyttöön koko organisaatiolle tai tietyille ryhmille.
Malliprojektin määrittäminen
Kloonaa säilö: Kloonaa säilö täältä: Malliprojektihakemisto
Asenna riippuvuudet: Siirry
Frontend
kloonatun säilön hakemistoon ja suorita seuraava komento:npm install
Käynnistä paikallinen palvelin: Käynnistä paikallinen Node.js palvelin suorittamalla
webpack
:npm start
Palvelin suoritetaan yleensä portissa
60006
. Vahvista, että palvelin on toiminnassa, käyttämällä127.0.0.1:60006/manifests
. env.dev määritystiedostoa edustakansiossa.Ota käyttöön edustan kehittäjätila: Ota käyttöön edustan kehittäjätila: Hallintaportaalin vuokraaja-asetuksissa, Lisäkuormitukset-osassa, ja aktivoi kapasiteetin järjestelmänvalvojat voivat kehittää lisää kuormituksia. Tämä asetus sallii yhteydet paikalliseen palvelimeen ja jatkuu selainistuntojen välillä.
Mallikuormituksen suorittaminen
Kun paikallinen palvelin on käynnissä ja kehittäjätila on käytössä, uusi mallikuormitus tulee näkyviin valikkoon.
- Käytä mallikuormitusta: Aloita Luo-kokemus siirtymällä mallikuormituksen aloitussivulle.
Kehitysympäristön valmisteleminen
Avaa ratkaisu: Avaa ratkaisu Visual Studio 2022 :ssa varmistaaksesi yhteensopivuuden net7:n kanssa.
Sovelluksen rekisteröinti: Määritä Microsoft Entra Id -todennus arkkitehtuurin suojattuja vuorovaikutuksia varten noudattamalla todennusopasta .
Kuormitusasetusten määrittäminen: Päivitä
src/Config/workload-dev-mode.json
jasrc/appsettings.json
käytä määritystietojasi:- Kopioi workload-dev-mode.json kohteesta src/Config
C:\
ja päivitä seuraavat kentät vastaamaan määritystäsi:
Muistiinpano
Voit kopioida sen mihin tahansa muuhun polkuun ja määrittää komentoriviargumentin "-DevMode:LocalConfigFilePath" projektissasi polun määrittämiseksi.
WorkspaceGuid: Työtilatunnuksesi. Etsi se selaimen URL-osoitteesta, kun valitset työtilan Fabricissa,
https://app.fabric.microsoft.com/groups/{WorkspaceID}/
esimerkiksi .ManifestPackageFilePath: Luettelotiedostopaketin sijainti. Kun luot ratkaisun, se tallentaa luettelopaketin src \bin\Debugiin. Lisätietoja luettelotiedostopaketista löytyy myöhemmmissä vaiheissa.
WorkloadEndpointURL: Kuormituksen päätepisteen URL-osoite.
Päivitä src/appsettings.json-tiedostossa seuraavat kentät vastaamaan määritystäsi:
- PublisherTenantId: Kuormituksen julkaisijan vuokraajan tunnus.
- Asiakastunnus: kuormituksen Microsoft Entra -sovelluksen asiakastunnus (AppID).
- ClientSecret: Microsoft Entra -sovelluksen kuormituksen salaisuus.
- Kohderyhmä: Saapuvien Microsoft Entra -tunnusten yleisö näkyy sovelluksen rekisteröinnissä kohdassa "Ohjelmointirajapinnan paljastaminen". Tätä kutsutaan myös sovellustunnuksen URI-tunnukseksi.
- Kopioi workload-dev-mode.json kohteesta src/Config
Määritä WorkloadManifest.xml tiedosto: Määritä WorkloadManifest.xml-tiedosto seuraavien Microsoft Entra -sovellustietojen avulla:
- AppID
- ResourceID
- RedirectURI
Kokoonpanotiedot-paketti: Luo ratkaisu, jolla luodaan kokoonpanopakettitiedosto, joka sisältää tarvittavan XML- ja JSON-tiedostojen vahvistamisen ja pakkaamisen.
- Käynnistä Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe workloadManifest.xml -toiminnossa tiedostossa Packages\manifest\files\ (voit etsiä vahvistusprosessin koodin \workloadManifestValidator-hakemistosta). Jos vahvistus epäonnistuu, luodaan virhetiedosto, joka määrittää epäonnistuneen vahvistuksen.
- Jos virhetiedosto on olemassa, koontiversio epäonnistuu "WorkloadManifest-vahvistusvirheen" kanssa. Voit kaksoisnapsauttaa virhettä VS Studiossa, ja näet virhetiedoston.
- Onnistuneen vahvistuksen jälkeen pakkaa WorkloadManifest.xml- ja FrontendManifest.json-tiedostot ManifestPackage.1.0.0.nupkg-tiedostoon. Tuloksena saatava paketti löytyy tiedostosta src\bin\Debug.
Kopioi ManifestPackage.1.0.0.nupkg-tiedosto workload-dev-mode.json määritystiedostossa määritettyyn polkuun.
Suorita DevGateway: Suorita Microsoft.Fabric.Workload.DevGateway.exe ja kirjaudu sisään käyttäjällä, jolla on työtilan järjestelmänvalvojan oikeudet workload-dev-mode.json -
WorkspaceGuid
kentässä määritettyyn työtilaan.Käynnistä projekti: Määritä Boilerplate-projekti Visual Studion käynnistysprojektiksi ja suorita se.
Lisävaiheet
- Päivitä kuormituksen määritystiedostot tarpeen mukaan.
- Luo ratkaisu, joka varmistaa, että kaikki riippuvuudet on linkitetty oikein.
- Suorita edusta ja devgateway yhteyden muodostamiseksi Fabric-taustan kanssa.
- Luo kohteita ja suorita töitä, jotta voit testata kuormituksesi kaikkia ominaisuuksia.