Workloadmanifest

Overzicht

De WorkloadManifest.xml en Item.xml bestanden zijn vereist voor de definitie van de workload in Fabric. Ze bevatten de basisconfiguratie-instellingen voor workload- en workloaditems voor de installatie en fungeren als richtlijn voor het instellen en beheren van werkbelastingen, om essentiële workloaddetails te definiëren, te delen en vast te leggen voor een soepele integratie in Fabric.

In onze voorbeeldopslagplaats wordt een .nupkg bestand gegenereerd op basis van de XML-bestanden in de src/Packages/manifest map tijdens het buildproces. Dit verpakte bestand bevat alle benodigde informatie over uw workload. In het workload-dev-mode.json bestand bevindt zich een veld met de naam ManifestPackageFilePath dat naar dit zojuist gemaakte .nupkg bestand moet verwijzen.

Upload- en registratieproces

1. Gebruikersverificatie: na het uitvoeren van het voorbeeld start uw verificatie het upload- en registratieproces tijdens de ontwikkeling. Dit zorgt voor de juiste koppeling van de workload met uw identiteit.
2. Manifestparsering: Het geüploade manifest ondergaat parseren om de structuur en inhoud ervan te valideren. Deze stap zorgt ervoor dat het manifest correct is opgemaakt en gereed is voor verdere verwerking.
3. Workloadregistratie: als parseren is geslaagd, wordt de workload geregistreerd in Fabric. Essentiële configuratiedetails, zoals de workload-id, worden opgeslagen in de Fabric-database, waardoor effectief workloadbeheer mogelijk is.

Workloadmanifest - Belangrijkste manifestonderdelen

Het manifest, waarvan de structuur is gedefinieerd door WorkloadDefinition.xsd, bevat een overzicht van kernkenmerken van een workload, zoals naam, toepassing en eindpunten.

Kenmerk SchemaVersion

Vertegenwoordigt de gepubliceerde versie workloadDefinition.xsd van Fabric.

Kenmerk WorkloadName

De unieke id van uw workload. Houd er rekening mee dat het verplicht is om een 'Org' te hebben. voorvoegsel voor workloadName, zodat de naam bestaat uit twee woorden met scheidingsteken '.', bijvoorbeeld 'Org.MyWorkload'. Andere voorvoegsels zijn ongeldig en veroorzaken een uploadfout. Dit wordt afgedwongen in de volgende scenario's: dev connection, Test upload.

Versie-element

De versie van uw manifest moet Voldoen aan SemVer .

CloudServiceConfiguration-element

De serviceconfiguratie van uw workload wordt momenteel slechts één configuratie ondersteund.

Microsoft Entra ID [Azure Active Directory (AAD)] Toepassingsconfiguratie

In <AADApp> de sectie wordt microsoft Entra ID [Azure Active Directory (AAD)] ingesteld voor verificatie- en autorisatieprocessen. Het AppId vertegenwoordigt de unieke id voor uw toepassing, de RedirectUri URI waarnaar microsoft Entra-id het verificatieantwoord verzendt en de ResourceId punten naar de unieke id voor de resource waartoe de toepassing toegang heeft. Voor meer context over wat ResourceId, AppIden RedirectUri vertegenwoordigt, kunt u verwijzen naar de verificatiedocumentatie.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

Raadpleeg de verificatiedocumentatie voor een dieper begrip van AppId, ResourceIden RedirectUri hun betekenis in de context van verificatieprocessen.

ServiceEndpoint-elementen

Vertegenwoordig de configuratie van een specifiek logisch eindpunt, bijvoorbeeld het back-end-eindpunt dat implementatie voor item CRUD en jobs-API's bevat.

• De configuratie voor het back-endeindpunt van de workload geeft de back-end-URL van uw workload weer.

<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>

• <IsEndpointResolutionService> en <EndpointResolutionContext> worden ingesteld op basis van of uw eindpunt de workload-API of alleen de oplossing van het eindpunt implementeert.
• Het opgeloste eindpunt dat door de service wordt geretourneerd, moet voldoen aan de volgende vereisten:
  • Het domein van het opgeloste eindpunt moet overeenkomen met het domein van de resource-id die in de WorkloadManifest.xmlis gevonden.
  • De opgeloste eindpunt-URL kan maximaal zes extra subdomeinen hebben vóór het hoofddomein.
  • Elk subdomein na het eerste segment moet behoren tot de lijst met geverifieerde domeinen van de uitgevertenant.

Voorbeeld

URL van resource-id:https://contoso.com/fe/be/Org.WorkloadSample (waarbij domein is contoso.com)

Geverifieerde domeinen in tenant:contoso.com, be.contoso.comeastus.be.contoso.com

Geldige opgeloste eindpunten:

• api.eastus.be.contoso.com
• be.contoso.com
• api.be.contoso.com

Ongeldige opgeloste eindpunten:

• api.eastus.fe.contoso.com (ongeldig omdat eastus.fe.contoso.com dit geen geverifieerd domein is)
• contoso-dev.com (ongeldig omdat contoso-dev.com dit geen geverifieerd domein is en ook niet overeenkomt met het hoofddomein van de resource-id)

• Zie Eindpuntomzetting voor meer informatie over het gebruik van de workload-client-API voor eindpuntresolutie.

Itemmanifest - Belangrijkste manifestonderdelen

Het manifest, waarvan de structuur is gedefinieerd door ItemDefinition.xsd, bevat een overzicht van de kernkenmerken van het item van een workload, zoals naam- en taakdefinities.

Kenmerk SchemaVersion

Vertegenwoordigt de gepubliceerde versie ItemDefinition.xsd van Fabric.

TypeName-kenmerk

De unieke id van uw item.

Taakplannerconfiguratie

De <JobScheduler> sectie bevat verschillende elementen die het gedrag en de instellingen van taakplanning, tracering en beheer definiëren.

• <OnDemandJobDeduplicateOptions> en <ScheduledJobDeduplicateOptions>: Definieer opties voor ontdubbeling voor respectievelijk taken op aanvraag en geplande items. Opties zijn onder andere None (geen ontdubbeling), PerItem (één taakuitvoering voor hetzelfde item en taaktype) en PerUser (één taakuitvoering voor dezelfde gebruiker en hetzelfde item).
• <ItemJobTypes>: bevat configuraties voor verschillende itemtaaktypen.
• <ItemJobType>: Beschrijft een specifiek taaktype.
• <Name>: De naam van het taaktype. Gebruik de naam van het item als voorvoegsel.

Laten we bijvoorbeeld eens kijken naar de voorbeeldworkload, die drie specifieke taken bevat die in de <ItemJobTypes> sectie zijn gedefinieerd:

<JobScheduler>
    <OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
    <ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
    <ItemJobTypes>
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
    </ItemJobTypes>
</JobScheduler>

• CalculateAsText-taak : dit taaktype verwerkt op tekst gebaseerde berekeningen, het maken Operand1 en Operand2uitvoeren van de geselecteerde bewerking en het opslaan van het resultaat in het lakehouse.
• CalculateAsParquet Job : Speciaal afgestemd op het werken met Parquet-gegevens, neemt Operand1 dit taaktype ook de geselecteerde bewerking en Operand2slaat het resultaat op in het lakehouse, volgens de Parquet-gegevensindeling. Zie de handleiding voor bewakingshubs voor meer informatie over taken en gerelateerde configuraties.

Kortom, de workload- en itemmanifesten fungeren als basisdocumenten voor het toevoegen van aangepaste workloads aan Fabric. Het verificatieproces activeert een eenvoudige reeks acties: uploaden, parseren en registreren, waardoor de juiste configuratie en efficiënt workloadbeheer in het Azure-ecosysteem worden gegarandeerd.