StartTask Classe
- java.
lang. Object - com.
microsoft. azure. management. batch. StartTask
- com.
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éinitialisé. 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 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écapitulatif du constructeur
Constructeur | Description | |
---|---|---|
StartTask() |
Résumé de la méthode
Modificateur et type | Méthode et description |
---|---|
java.lang.String |
commandLine()
Obtenir que 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. |
Task |
containerSettings()
Obtient lorsque cela est spécifié, tous les répertoires sous la AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) sont mappés 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. |
java.util.List<Environment |
environmentSettings()
Obtenez la valeur paramètres de l’environnement |
java.lang.Integer |
maxTaskRetryCount()
Obtenez le service Batch réessayer une tâche si son code de sortie est différent de zéro. |
java.util.List<Resource |
resourceFiles()
Obtenez la valeur fichiers de ressource |
User |
userIdentity()
Obtient en cas d’omission, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche. |
java.lang.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 (nombre maximal |
Start |
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. |
Start |
withContainerSettings(TaskContainerSettings containerSettings)
Défini lorsque ce paramètre est spécifié, tous les répertoires sous le AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) sont mappés 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. |
Start |
withEnvironmentSettings(List<EnvironmentSetting> environmentSettings)
Définissez la valeur paramètres de l’environnement |
Start |
withMaxTaskRetryCount(Integer maxTaskRetryCount)
Définissez le service Batch retente une tâche si son code de sortie est différent de zéro. |
Start |
withResourceFiles(List<ResourceFile> resourceFiles)
Définissez la valeur fichiers de ressource |
Start |
withUserIdentity(UserIdentity userIdentity)
Définie si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche. |
Start |
withWaitForSuccess(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 (nombre maximal |
Méthodes héritées de java.lang.Object
Détails du constructeur
StartTask
public StartTask()
Détails de la méthode
commandLine
public String commandLine()
Obtenir que 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 de startTask sont spécifiées.
Returns:
containerSettings
public TaskContainerSettings containerSettings()
Obtient lorsque cela est spécifié, tous les répertoires sous la AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) sont mappés 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.
Returns:
environmentSettings
public List
Obtenez la valeur environmentSettings.
Returns:
maxTaskRetryCount
public Integer maxTaskRetryCount()
Obtenez le service Batch réessayer 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 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 -1, le service Batch retente la tâche sans limite.
Returns:
resourceFiles
public List
Obtenez la valeur resourceFiles.
Returns:
userIdentity
public UserIdentity userIdentity()
Obtient en cas d’omission, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.
Returns:
waitForSuccess
public Boolean waitForSuccess()
Obtenez la valeur 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 ne s’est toujours pas terminée correctement 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 les détails 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.
Returns:
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 de startTask sont spécifiées.
Parameters:
Returns:
withContainerSettings
public StartTask withContainerSettings(TaskContainerSettings containerSettings)
Défini lorsque ce paramètre est spécifié, tous les répertoires sous le AZ_BATCH_NODE_ROOT_DIR (la racine de Azure Batch répertoires sur le nœud) sont mappés 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.
Parameters:
Returns:
withEnvironmentSettings
public StartTask withEnvironmentSettings(List
Définissez la valeur environmentSettings.
Parameters:
Returns:
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 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 -1, le service Batch retente la tâche sans limite.
Parameters:
Returns:
withResourceFiles
public StartTask withResourceFiles(List
Définissez la valeur resourceFiles.
Parameters:
Returns:
withUserIdentity
public StartTask withUserIdentity(UserIdentity userIdentity)
Définie si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.
Parameters:
Returns:
withWaitForSuccess
public StartTask withWaitForSuccess(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 ne s’est toujours pas terminée correctement 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 les détails 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.
Parameters:
Returns:
S’applique à
Azure SDK for Java