Sdílet prostřednictvím

Manifest úlohy

  • Článek

Přehled

Soubory WorkloadManifest.xml a Item.xml soubory jsou vyžadovány pro definici úlohy v prostředcích infrastruktury. Uchovávají základní nastavení konfigurace úloh a položek úloh pro nastavení a fungují jako vodítko pro nastavení a správu úloh, pomáhají definovat, sdílet a zaznamenávat základní podrobnosti úloh pro bezproblémovou integraci do prostředků infrastruktury.

V našem ukázkovém úložišti se vygeneruje .nupkg soubor ze souborů XML umístěných src/Packages/manifest ve složce během procesu sestavení. Tento zabalený soubor obsahuje všechny potřebné informace o vaší úloze. workload-dev-mode.json V souboru je pole s názvemManifestPackageFilePath, které by mělo odkazovat na tento nově vytvořený .nupkg soubor.

Proces nahrávání a registrace

  1. Ověřování uživatelů: Během vývoje se po spuštění ukázky zahájí proces nahrávání a registrace. Tím zajistíte správné přidružení úlohy k vaší identitě.
  2. Analýza manifestu: Nahraný manifest prochází analýzou a ověří jeho strukturu a obsah. Tento krok zajistí, že je manifest správně naformátovaný a připravený k dalšímu zpracování.
  3. Registrace úlohy: Pokud je analýza úspěšná, úloha se zaregistruje v prostředcích infrastruktury. Základní podrobnosti konfigurace, jako je ID úlohy, se ukládají do databáze Prostředků infrastruktury a umožňují efektivní správu úloh.

Manifest úlohy – klíčové součásti manifestu

Manifest, jehož struktura je definována funkcí WorkloadDefinition.xsd, popisuje základní atributy úlohy, jako je název, aplikace a koncové body.

Atribut SchemaVersion

Představuje publikovanou verzi WorkloadDefinition.xsd infrastruktury.

Atribut WorkloadName

Jedinečný identifikátor vaší úlohy Mějte na paměti, že je nutné mít "org". předpona pro název úlohy se skládá ze dvou slov s oddělovačem ".", např. "Org.MyWorkload". Jiné předpony jsou neplatné a způsobí selhání nahrávání. To se vynutí v následujících scénářích – vývojové připojení, testovací nahrání.

Version Element

Verze manifestu by měla odpovídat předpisům SemVer .

CloudServiceConfiguration Element

Konfigurace služby vaší úlohy je aktuálně podporovaná pouze jednou konfigurací.

Konfigurace aplikace Microsoft Entra ID [Azure Active Directory (AAD)]

Tato <AADApp> část nastaví aplikaci Microsoft Entra ID [Azure Active Directory (AAD)] pro procesy ověřování a autorizace. Představuje AppId jedinečný identifikátor vaší aplikace, určuje identifikátor URI, RedirectUri ke kterému bude ID Microsoft Entra odesílat odpověď ověřování, a ResourceId odkazuje na jedinečný identifikátor prostředku, ke kterému aplikace přistupuje. Další kontext k tomu, co ResourceIda AppIdRedirectUri představuje, najdete v dokumentaci k ověřování.

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

V dokumentaci k ověřování lépe porozumněl AppId, ResourceIda RedirectUri jejich význam v kontextu ověřovacích procesů.

Elementy ServiceEndpoint

Představuje konfiguraci konkrétního logického koncového bodu, například back-endový koncový bod, který zahrnuje implementaci rozhraní CRUD položek a rozhraní API úloh.

  • Konfigurace back-endového koncového bodu úlohy uvádí adresu URL back-endu vaší úlohy.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • <IsEndpointResolutionService> a EndpointResolutionContext jsou nastavené na základě toho, jestli váš koncový bod implementuje rozhraní API pro úlohy, nebo pouze překlad koncového bodu. Podrobné informace o kontextu řešení a odpovědi najdete v tématu Řešení koncových bodů.

Poznámka:

Překlad koncového bodu pro front-end se nepodporuje.

Manifest položky – klíčové součásti manifestu

Manifest, jehož struktura je definována ItemDefinition.xsd, popisuje základní atributy položky úlohy, jako je název a definice úlohy.

Atribut SchemaVersion

Představuje publikovanou verzi ItemDefinition.xsd fabric.

Atribut TypeName

Jedinečný identifikátor položky

Konfigurace plánovače úloh

Tato <JobScheduler> část zahrnuje různé prvky, které definují chování a nastavení plánování, sledování a správy úloh.

  • <OnDemandJobDeduplicateOptions> and <ScheduledJobDeduplicateOptions>: Definujte možnosti odstranění duplicitních dat pro úlohy na vyžádání a naplánované položky. Mezi možnosti patří None (bez odstranění duplicit), PerItem (jedna úloha se spustí pro stejnou položku a typ úlohy) a PerUser (jedna úloha se spustí pro stejného uživatele a položku).
  • <ItemJobTypes>: Obsahuje konfigurace pro různé typy úloh položek.
  • <ItemJobType>: Popisuje konkrétní typ úlohy.
  • <Name>: Název typu úlohy. Jako předponu musí být použit název položky.

Podívejme se například na naši ukázkovou úlohu, která zahrnuje tři konkrétní úlohy definované v <ItemJobTypes> této části:

<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>
  • Úloha CalculateAsText: Tento typ úlohy zpracovává textové výpočty, přebírá Operand1 a Operand2provádí vybranou operaci a ukládá výsledek v jezeře.
  • CalculateAsParquet Job : Speciálně přizpůsobená pro práci s daty Parquet, tento typ úlohy také přebírá Operand1 a Operand2provádí vybranou operaci a ukládá výsledek do jezerahouse, a to za formátem dat Parquet. Další informace o úlohách a související konfiguraci najdete v průvodci centrem monitorování.

Manifesty úloh a položek v souhrnu slouží jako základní dokumenty pro přidávání vlastních úloh do prostředků infrastruktury. Proces ověřování aktivuje jednoduchou posloupnost akcí: nahrávání, analýzu a registraci, zaručuje správnou konfiguraci a efektivní správu úloh v ekosystému Azure.