BatchJobPreparationTask interface

De commandoregel van de Job Preparation Task. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als je van zulke functies wilt profiteren, moet je de shell aanroepen in de opdrachtregel, bijvoorbeeld met "cmd /c MyCommand" in Windows of "/bin/sh -c MyCommand" in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://dotnet.territoriali.olinfo.it/azure/batch/batch-compute-node-environment-variables).

Beperkingen die van toepassing zijn op de Job Preparation Task.

De instellingen voor de container waaronder de taak Job Preparation Task draait. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch directories op de node) in de container gemapt, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-commandoregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben.

Een lijst met instellingen voor omgevingsvariabelen voor de taak Jobvoorbereiding.

Een string die de Job Preparation Task uniek binnen de Job identificeert. De ID kan elke combinatie van alfanumerieke tekens bevatten, inclusief koppeltekens en onderstreepjes, en mag niet meer dan 64 tekens bevatten. Als je deze eigenschap niet specificeert, kent de Batch-service een standaardwaarde toe van 'jobpreparation'. Geen enkele andere taak in de functie kan dezelfde ID hebben als de taakvoorbereidingstaak. Als je probeert een Task met hetzelfde id in te dienen, wijst de Batch-service het verzoek met de foutcode TaskIdSameAsJobPreparationTask af; als je de REST API direct aanroept, is de HTTP-statuscode 409 (Conflict).

Of de Batch-service de Job Preparation Task opnieuw moet uitvoeren nadat een Compute Node is herstart. De taak voorbereiding wordt altijd opnieuw uitgevoerd als een rekenknoop opnieuw wordt geimaged, of als de taak voorbereiding niet is voltooid (bijvoorbeeld omdat de herstart plaatsvond terwijl de taak draaide). Daarom moet je altijd een Job Preparation Task schrijven om idempotent te zijn en correct te functioneren als je deze meerdere keren uitvoert. De standaardwaarde is waar.

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers.

De gebruikersidentiteit waaronder de Job Preparation Task wordt uitgevoerd. Indien weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak op Windows Compute Nodes, of als een niet-administratieve gebruiker uniek voor de Pool op Linux Compute Nodes.

Of de batchservice moet wachten tot de taak voorbereidingstaak succesvol is afgerond voordat andere taken van de taak op de rekenknoop worden gepland. Een Job Preparation Task is succesvol voltooid als deze afsluit met exitcode 0. Als het waar is en de Job Preparation Task faalt op een Node, probeert de Batch-service de Job Preparation Task opnieuw tot het maximale aantal retrys (zoals gespecificeerd in het constraints-element). Als de taak na alle herpogingen nog steeds niet succesvol is voltooid, zal de batchservice de taken van de taak niet naar de Node plannen. De Node blijft actief en komt in aanmerking om taken van andere taken uit te voeren. Als het niet klopt, wacht de batchservice niet tot de taak Job Preparation is voltooid. In dat geval kunnen andere taken van de taak beginnen met uitvoeren op de Compute Node terwijl de Job Preparation Task nog draait; en zelfs als de taak voor taakvoorbereiding faalt, blijven nieuwe taken worden gepland op de rekenknoop. De standaardwaarde is waar.