BatchTaskCreateOptions interface

Pacchetto:

@azure/batch

Parametri per creare un Azure Batch Task.

Proprietà

affinityInfo	Un suggerimento di località che può essere usato dal servizio Batch per selezionare un Nodo di Calcolo su cui iniziare il nuovo Task.
applicationPackageReferences	Un elenco dei pacchetti che il servizio Batch distribuirà al Nodo di Calcolo prima di eseguire la riga di comando. I pacchetti applicativi vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro Task. Pertanto, se un pacchetto di riferimento è già presente nel Nodo ed è aggiornato, non viene riscaricato; viene utilizzata la copia esistente sul Nodo di Calcolo. Se un Pacchetto di riferimento non può essere installato, ad esempio perché il pacchetto è stato eliminato o perché il download è fallito, il Task fallisce.
commandLine	La riga di comando del Compito. Per i compiti multi-istanza, la riga di comando viene eseguita come compito primario, dopo che il compito primario e tutti i sottocompiti hanno terminato l'esecuzione della linea di comando di coordinamento. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se vuoi sfruttare queste funzionalità, dovresti invocare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" su Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	I vincoli di esecuzione che si applicano a questo Compito. Se non specifichi vincoli, il maxTaskRetryCount è il maxTaskRetryCount specificato per il Job, il maxWallClockTime, è infinito e il retentionTime, è di 7 giorni.
containerSettings	Le impostazioni del contenitore sotto cui viene eseguita il Task. Se il Pool che eseguirà questo Task ha containerConfiguration impostato, anche questo deve essere impostato. Se il Pool che eseguirà questo Task non ha containerConfiguration impostato, questo non deve essere impostato. Quando ciò viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle cartelle di Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.
dependsOn	I compiti da cui dipende questo compito. Questo compito non sarà programmato finché tutti i compiti da cui dipende non saranno completati con successo. Se uno di questi Compiti fallisce ed esaurisce il numero di ritentativi, questo Compito non verrà mai programmato. Se il Job non ha usesTaskDependencies impostato su true e questo elemento è presente, la richiesta fallisce con il codice di errore TaskDependenciesNotSpecifiedOnJob.
displayName	Un nome visualizzato per il Compito. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
environmentSettings	Un elenco delle impostazioni delle variabili ambientali per il Task.
exitConditions	Come dovrebbe rispondere il servizio batch al completamento del compito.
id	Una stringa che identifica in modo unico il Compito all'interno del Lavoro. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID preserva le case e non è insensibile alla maiuscola (cioè, potresti non avere due ID all'interno di un Job che differiscono solo per caso).
multiInstanceSettings	Un oggetto che indica che il Task è un Task multi-istanze e contiene informazioni su come eseguire il Task multi-istanza.
outputFiles	Un elenco dei file che il servizio Batch caricherà dal Nodo di Calcolo dopo aver eseguito la riga di comando. Per i Task multi-istanza, i file verranno caricati solo dal Nodo di Calcolo su cui viene eseguito il Task principale.
requiredSlots	Il numero di slot di programmazione che il Compito richiedeva per essere eseguito. L'impostazione predefinita è 1. Un Task può essere programmato per essere eseguito su un nodo di calcolo solo se il nodo dispone di abbastanza slot di programmazione liberi. Per i Task multi-istanze, questo deve essere 1.
resourceFiles	Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. Per i compiti multi-istanza, i file di risorse verranno scaricati solo nel nodo di calcolo su cui viene eseguito il compito principale. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker.
userIdentity	L'identità utente sotto cui viene eseguito il Task. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.

Dettagli proprietà

affinityInfo

Un suggerimento di località che può essere usato dal servizio Batch per selezionare un Nodo di Calcolo su cui iniziare il nuovo Task.

affinityInfo?: BatchAffinityInfo

Valore della proprietà

BatchAffinityInfo

applicationPackageReferences

Un elenco dei pacchetti che il servizio Batch distribuirà al Nodo di Calcolo prima di eseguire la riga di comando. I pacchetti applicativi vengono scaricati e distribuiti in una directory condivisa, non nella directory di lavoro Task. Pertanto, se un pacchetto di riferimento è già presente nel Nodo ed è aggiornato, non viene riscaricato; viene utilizzata la copia esistente sul Nodo di Calcolo. Se un Pacchetto di riferimento non può essere installato, ad esempio perché il pacchetto è stato eliminato o perché il download è fallito, il Task fallisce.

applicationPackageReferences?: BatchApplicationPackageReference[]

Valore della proprietà

BatchApplicationPackageReference[]

commandLine

La riga di comando del Compito. Per i compiti multi-istanza, la riga di comando viene eseguita come compito primario, dopo che il compito primario e tutti i sottocompiti hanno terminato l'esecuzione della linea di comando di coordinamento. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se vuoi sfruttare queste funzionalità, dovresti invocare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" su Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (relativo alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

commandLine: string

Valore della proprietà

string

constraints

I vincoli di esecuzione che si applicano a questo Compito. Se non specifichi vincoli, il maxTaskRetryCount è il maxTaskRetryCount specificato per il Job, il maxWallClockTime, è infinito e il retentionTime, è di 7 giorni.

constraints?: BatchTaskConstraints

Valore della proprietà

BatchTaskConstraints

containerSettings

Le impostazioni del contenitore sotto cui viene eseguita il Task. Se il Pool che eseguirà questo Task ha containerConfiguration impostato, anche questo deve essere impostato. Se il Pool che eseguirà questo Task non ha containerConfiguration impostato, questo non deve essere impostato. Quando ciò viene specificato, tutte le directory ricorsivamente sotto la AZ_BATCH_NODE_ROOT_DIR (la radice delle cartelle di Azure Batch sul nodo) vengono mappate nel container, tutte le variabili dell'ambiente Task vengono mappate nel container e la riga di comando Task viene eseguita nel container. I file prodotti nel contenitore al di fuori di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi sul disco host, il che significa che le API dei file Batch non potranno accedere a quei file.

containerSettings?: BatchTaskContainerSettings

Valore della proprietà

BatchTaskContainerSettings

dependsOn

I compiti da cui dipende questo compito. Questo compito non sarà programmato finché tutti i compiti da cui dipende non saranno completati con successo. Se uno di questi Compiti fallisce ed esaurisce il numero di ritentativi, questo Compito non verrà mai programmato. Se il Job non ha usesTaskDependencies impostato su true e questo elemento è presente, la richiesta fallisce con il codice di errore TaskDependenciesNotSpecifiedOnJob.

dependsOn?: BatchTaskDependencies

Valore della proprietà

BatchTaskDependencies

displayName

Un nome visualizzato per il Compito. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

displayName?: string

Valore della proprietà

string

environmentSettings

Un elenco delle impostazioni delle variabili ambientali per il Task.

environmentSettings?: EnvironmentSetting[]

Valore della proprietà

EnvironmentSetting[]

exitConditions

Come dovrebbe rispondere il servizio batch al completamento del compito.

exitConditions?: ExitConditions

Valore della proprietà

ExitConditions

id

Una stringa che identifica in modo unico il Compito all'interno del Lavoro. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID preserva le case e non è insensibile alla maiuscola (cioè, potresti non avere due ID all'interno di un Job che differiscono solo per caso).

id: string

Valore della proprietà

string

multiInstanceSettings

Un oggetto che indica che il Task è un Task multi-istanze e contiene informazioni su come eseguire il Task multi-istanza.

multiInstanceSettings?: MultiInstanceSettings

Valore della proprietà

MultiInstanceSettings

outputFiles

Un elenco dei file che il servizio Batch caricherà dal Nodo di Calcolo dopo aver eseguito la riga di comando. Per i Task multi-istanza, i file verranno caricati solo dal Nodo di Calcolo su cui viene eseguito il Task principale.

outputFiles?: OutputFile[]

Valore della proprietà

OutputFile[]

requiredSlots

Il numero di slot di programmazione che il Compito richiedeva per essere eseguito. L'impostazione predefinita è 1. Un Task può essere programmato per essere eseguito su un nodo di calcolo solo se il nodo dispone di abbastanza slot di programmazione liberi. Per i Task multi-istanze, questo deve essere 1.

requiredSlots?: number

Valore della proprietà

number

resourceFiles

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. Per i compiti multi-istanza, i file di risorse verranno scaricati solo nel nodo di calcolo su cui viene eseguito il compito principale. È prevista una dimensione massima per l'elenco dei file di risorse. Quando viene superata la dimensione massima, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta di dimensioni. A tale scopo, è possibile usare .zip file, pacchetti di applicazioni o contenitori Docker.

resourceFiles?: ResourceFile[]

Valore della proprietà

ResourceFile[]

userIdentity

L'identità utente sotto cui viene eseguito il Task. Se omesso, il Task viene eseguito come un utente non amministrativo unico per il Task.

userIdentity?: UserIdentity

Valore della proprietà

UserIdentity