Partager via


StartTask Classe

  • java.lang.Object
    • com.microsoft.azure.management.batch.StartTask

public class StartTask

Tâche exécutée lorsqu’un nœud de calcul joint un pool dans le service Azure Batch, ou lorsque le nœud de calcul est redémarré ou réimagené. Dans certains cas, la tâche de démarrage peut être réexécuter même si le nœud n’a pas été redémarré. Pour cette raison, les tâches de démarrage doivent être idempotentes et quitter correctement si la configuration qu’elles effectuent a déjà été effectuée. Une attention particulière doit être prise pour éviter les tâches de démarrage qui créent un processus d’interruption ou qui installent/lancent des services à partir du répertoire de travail de la tâche de démarrage, car cela empêchera Batch de pouvoir réexécuter la tâche de démarrage.

Résumé de la méthode

Modificateur et type Méthode et description
String commandLine()

Obtenir la ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes, telles que l’expansion des variables d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés du startTask sont spécifiées.

TaskContainerSettings containerSettings()

Lorsque cela est spécifié, tous les répertoires sont mappés de manière récursive sous la AZ_BATCH_NODE_ROOT_DIR (la racine des répertoires Azure Batch sur le nœud) dans le conteneur, toutes les variables d’environnement de tâche sont mappées dans le conteneur et la ligne de commande de la tâche est exécutée dans le conteneur.

List<EnvironmentSetting> environmentSettings()

Obtenez la valeur environmentSettings.

Integer maxTaskRetryCount()

Obtenez le service Batch réessayer une tâche si son code de sortie n’est pas nul. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une fois et peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est de 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est de -1, le service Batch retente la tâche sans limite.

List<ResourceFile> resourceFiles()

Obtenez la valeur resourceFiles.

UserIdentity userIdentity()

Obtenir en cas d’omission, la tâche s’exécute en tant qu’utilisateur non administratif propre à la tâche.

Boolean waitForSuccess()

Si la valeur est true et que la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et le détail de l’erreur de planification. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, de nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est true.

StartTask withCommandLine(String commandLine)

Définir la ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes, telles que l’expansion des variables d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés du startTask sont spécifiées.

StartTask withContainerSettings(TaskContainerSettings containerSettings)

Lorsque cela est spécifié, tous les répertoires sont mappés de manière récursive sous le AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) dans le conteneur, toutes les variables d’environnement de tâche sont mappées dans le conteneur et la ligne de commande de tâche est exécutée dans le conteneur.

StartTask withEnvironmentSettings(List<EnvironmentSetting> environmentSettings)

Définissez la valeur environmentSettings.

StartTask withMaxTaskRetryCount(Integer maxTaskRetryCount)

Définissez le service Batch retente une tâche si son code de sortie est différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une fois et peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est de 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est de -1, le service Batch retente la tâche sans limite.

StartTask withResourceFiles(List<ResourceFile> resourceFiles)

Définissez la valeur resourceFiles.

StartTask withUserIdentity(UserIdentity userIdentity)

Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif propre à la tâche.

StartTask withWaitForSuccess(Boolean waitForSuccess)

Définissez si true et si la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et le détail de l’erreur de planification. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, de nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est true.

Détails de la méthode

commandLine

public String commandLine()

Obtenir la ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes, telles que l’expansion des variables d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés du startTask sont spécifiées.

Retours:

valeur commandLine

containerSettings

public TaskContainerSettings containerSettings()

Lorsque cela est spécifié, tous les répertoires sont mappés de manière récursive sous la AZ_BATCH_NODE_ROOT_DIR (la racine des répertoires Azure Batch sur le nœud) dans le conteneur, toutes les variables d’environnement de tâche sont mappées dans le conteneur et la ligne de commande de la tâche est exécutée dans le conteneur.

Retours:

valeur containerSettings

environmentSettings

public List environmentSettings()

Obtenez la valeur environmentSettings.

Retours:

valeur environmentSettings

maxTaskRetryCount

public Integer maxTaskRetryCount()

Obtenez le service Batch réessayer une tâche si son code de sortie n’est pas nul. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une fois et peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est de 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est de -1, le service Batch retente la tâche sans limite.

Retours:

valeur maxTaskRetryCount

resourceFiles

public List resourceFiles()

Obtenez la valeur resourceFiles.

Retours:

valeur resourceFiles

userIdentity

public UserIdentity userIdentity()

Obtenir en cas d’omission, la tâche s’exécute en tant qu’utilisateur non administratif propre à la tâche.

Retours:

valeur userIdentity

waitForSuccess

public Boolean waitForSuccess()

Si la valeur est true et que la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et le détail de l’erreur de planification. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, de nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est true.

Retours:

valeur waitForSuccess

withCommandLine

public StartTask withCommandLine(String commandLine)

Définir la ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes, telles que l’expansion des variables d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés du startTask sont spécifiées.

Paramètres:

commandLine - valeur commandLine à définir

Retours:

l’objet StartTask lui-même.

withContainerSettings

public StartTask withContainerSettings(TaskContainerSettings containerSettings)

Lorsque cela est spécifié, tous les répertoires sont mappés de manière récursive sous le AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) dans le conteneur, toutes les variables d’environnement de tâche sont mappées dans le conteneur et la ligne de commande de tâche est exécutée dans le conteneur.

Paramètres:

containerSettings - valeur containerSettings à définir

Retours:

l’objet StartTask lui-même.

withEnvironmentSettings

public StartTask withEnvironmentSettings(List environmentSettings)

Définissez la valeur environmentSettings.

Paramètres:

environmentSettings - valeur environmentSettings à définir

Retours:

l’objet StartTask lui-même.

withMaxTaskRetryCount

public StartTask withMaxTaskRetryCount(Integer maxTaskRetryCount)

Définissez le service Batch retente une tâche si son code de sortie est différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une fois et peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est de 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est de -1, le service Batch retente la tâche sans limite.

Paramètres:

maxTaskRetryCount - valeur maxTaskRetryCount à définir

Retours:

l’objet StartTask lui-même.

withResourceFiles

public StartTask withResourceFiles(List resourceFiles)

Définissez la valeur resourceFiles.

Paramètres:

resourceFiles - valeur resourceFiles à définir

Retours:

l’objet StartTask lui-même.

withUserIdentity

public StartTask withUserIdentity(UserIdentity userIdentity)

Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif propre à la tâche.

Paramètres:

userIdentity - valeur userIdentity à définir

Retours:

l’objet StartTask lui-même.

withWaitForSuccess

public StartTask withWaitForSuccess(Boolean waitForSuccess)

Définissez si true et si la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et le détail de l’erreur de planification. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, de nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est true.

Paramètres:

waitForSuccess - valeur waitForSuccess à définir

Retours:

l’objet StartTask lui-même.

S’applique à