StartTask interface

Pakket:

@azure/arm-batch

In sommige gevallen kan de begintaak opnieuw worden uitgevoerd, ook al is het knooppunt niet opnieuw opgestart. Hierdoor moeten begintaken idempotent zijn en zonder problemen afsluiten als de installatie die ze uitvoeren al is uitgevoerd. Er moet speciale aandacht worden besteed aan het vermijden van begintaken die een onderbrekingsproces maken of services installeren/starten vanuit de werkmap voor begintaken, omdat Hierdoor batch de begintaak niet opnieuw kan uitvoeren.

Eigenschappen

commandLine	De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven.
containerSettings	Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen voor taken toegewezen aan de container en wordt de opdrachtregel van de taak uitgevoerd in de container.
environmentSettings	Een lijst met omgevingsvariabeleinstellingen voor de begintaak.
maxTaskRetryCount	De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet. De standaardwaarde is 0
resourceFiles	Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert.
userIdentity	Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak.
waitForSuccess	Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is waar.

Eigenschapdetails

commandLine

De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Vereist als er andere eigenschappen van de startTask zijn opgegeven.

commandLine?: string

Waarde van eigenschap

string

containerSettings

Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen voor taken toegewezen aan de container en wordt de opdrachtregel van de taak uitgevoerd in de container.

containerSettings?: TaskContainerSettings

Waarde van eigenschap

TaskContainerSettings

environmentSettings

Een lijst met omgevingsvariabeleinstellingen voor de begintaak.

environmentSettings?: EnvironmentSetting[]

Waarde van eigenschap

EnvironmentSetting[]

maxTaskRetryCount

De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet. De standaardwaarde is 0

maxTaskRetryCount?: number

Waarde van eigenschap

number

resourceFiles

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert.

resourceFiles?: ResourceFile[]

Waarde van eigenschap

ResourceFile[]

userIdentity

Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak.

userIdentity?: UserIdentity

Waarde van eigenschap

UserIdentity

waitForSuccess

Als waar is en de begintaak mislukt op een rekenknooppunt, probeert de Batch-service de opstarttaak opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het rekenknooppunt onbruikbaar en worden er geen taken naar gepland. Deze voorwaarde kan worden gedetecteerd via de knooppuntstatus en planningsfoutdetails. Als dit onwaar is, wacht de Batch-service niet totdat de begintaak is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de begintaak nog steeds wordt uitgevoerd; en zelfs als de begintaak mislukt, blijven nieuwe taken gepland op het knooppunt. De standaardwaarde is waar.

waitForSuccess?: boolean

Waarde van eigenschap

boolean