StartTask Clase

Paquete:

com.microsoft.azure.management.batch

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

public class StartTask

Tarea que se ejecuta cuando un nodo de proceso se une a un grupo en el servicio Azure Batch, o cuando se reinicia o se vuelve a crear una imagen inicial del nodo de proceso. En algunos casos, la tarea de inicio puede volver a ejecutarse aunque el nodo no se haya reiniciado. Debido a esto, las tareas de inicio deben ser idempotentes y salir correctamente si la configuración que están realizando ya se ha realizado. Se debe tener especial cuidado para evitar que las tareas de inicio creen un proceso de interrupción o instalen o inicien servicios desde el directorio de trabajo de la tarea de inicio, ya que esto impedirá que Batch pueda volver a ejecutar la tarea de inicio.

Resumen del método

Modificador y tipo	Método y descripción
String	commandLine() Obtener la línea de comandos no se ejecuta en un shell y, por tanto, no puede aprovechar las características del shell, como la expansión de variables de entorno. Si desea aprovechar estas características, debe invocar el shell en la línea de comandos, por ejemplo, mediante "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux. Obligatorio si se especifican otras propiedades de startTask.
TaskContainerSettings	containerSettings() Obtenga cuando se especifica, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de Azure Batch directorios del nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor.
List<EnvironmentSetting>	environmentSettings() Obtenga el valor environmentSettings.
Integer	maxTaskRetryCount() Obtiene el servicio Batch reintenta una tarea si su código de salida es distinto de cero. Tenga en cuenta que este valor controla específicamente el número de reintentos. El servicio de Batch intentará una vez la tarea y podría reintentarla hasta alcanzar este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite.
List<ResourceFile>	resourceFiles() Obtenga el valor resourceFiles.
UserIdentity	userIdentity() Obtiene si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea.
Boolean	waitForSuccess() Obtenga si es true y se produce un error en la tarea de inicio en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas se seguirán programando en el nodo. El valor predeterminado es true.
StartTask	withCommandLine(String commandLine) Establezca la línea de comandos no se ejecuta en un shell y, por tanto, no puede aprovechar las características del shell, como la expansión de variables de entorno. Si desea aprovechar estas características, debe invocar el shell en la línea de comandos, por ejemplo, mediante "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux. Obligatorio si se especifican otras propiedades de startTask.
StartTask	withContainerSettings(TaskContainerSettings containerSettings) Cuando se especifica, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de Azure Batch directorios del nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor.
StartTask	withEnvironmentSettings(List<EnvironmentSetting> environmentSettings) Establezca el valor environmentSettings.
StartTask	withMaxTaskRetryCount(Integer maxTaskRetryCount) Establezca el servicio Batch reintenta una tarea si su código de salida es distinto de cero. Tenga en cuenta que este valor controla específicamente el número de reintentos. El servicio de Batch intentará una vez la tarea y podría reintentarla hasta alcanzar este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite.
StartTask	withResourceFiles(List<ResourceFile> resourceFiles) Establezca el valor resourceFiles.
StartTask	withUserIdentity(UserIdentity userIdentity) Establezca si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea.
StartTask	withWaitForSuccess(Boolean waitForSuccess) Establezca si es true y se produce un error en la tarea de inicio en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas se seguirán programando en el nodo. El valor predeterminado es true.

Detalles del método

commandLine

public String commandLine()

Obtener la línea de comandos no se ejecuta en un shell y, por tanto, no puede aprovechar las características del shell, como la expansión de variables de entorno. Si desea aprovechar estas características, debe invocar el shell en la línea de comandos, por ejemplo, mediante "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux. Obligatorio si se especifican otras propiedades de startTask.

Devoluciones:

el valor commandLine

containerSettings

public TaskContainerSettings containerSettings()

Obtenga cuando se especifica, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de Azure Batch directorios del nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor.

Devoluciones:

el valor containerSettings

environmentSettings

public List environmentSettings()

Obtenga el valor environmentSettings.

Devoluciones:

valor environmentSettings

maxTaskRetryCount

public Integer maxTaskRetryCount()

Obtiene el servicio Batch reintenta una tarea si su código de salida es distinto de cero. Tenga en cuenta que este valor controla específicamente el número de reintentos. El servicio de Batch intentará una vez la tarea y podría reintentarla hasta alcanzar este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite.

Devoluciones:

el valor maxTaskRetryCount

resourceFiles

public List resourceFiles()

Obtenga el valor resourceFiles.

Devoluciones:

el valor resourceFiles

userIdentity

public UserIdentity userIdentity()

Obtiene si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea.

Devoluciones:

el valor userIdentity

waitForSuccess

public Boolean waitForSuccess()

Obtenga si es true y se produce un error en la tarea de inicio en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas se seguirán programando en el nodo. El valor predeterminado es true.

Devoluciones:

el valor waitForSuccess

withCommandLine

public StartTask withCommandLine(String commandLine)

Establezca la línea de comandos no se ejecuta en un shell y, por tanto, no puede aprovechar las características del shell, como la expansión de variables de entorno. Si desea aprovechar estas características, debe invocar el shell en la línea de comandos, por ejemplo, mediante "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux. Obligatorio si se especifican otras propiedades de startTask.

Parámetros:

commandLine - el valor commandLine que se va a establecer

Devoluciones:

El propio objeto StartTask.

withContainerSettings

public StartTask withContainerSettings(TaskContainerSettings containerSettings)

Cuando se especifica, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de Azure Batch directorios del nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor.

Parámetros:

containerSettings - valor containerSettings que se va a establecer

Devoluciones:

El propio objeto StartTask.

withEnvironmentSettings

public StartTask withEnvironmentSettings(List environmentSettings)

Establezca el valor environmentSettings.

Parámetros:

environmentSettings - valor environmentSettings que se va a establecer

Devoluciones:

El propio objeto StartTask.

withMaxTaskRetryCount

public StartTask withMaxTaskRetryCount(Integer maxTaskRetryCount)

Establezca el servicio Batch reintenta una tarea si su código de salida es distinto de cero. Tenga en cuenta que este valor controla específicamente el número de reintentos. El servicio de Batch intentará una vez la tarea y podría reintentarla hasta alcanzar este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite.

Parámetros:

maxTaskRetryCount - El valor maxTaskRetryCount que se va a establecer

Devoluciones:

El propio objeto StartTask.

withResourceFiles

public StartTask withResourceFiles(List resourceFiles)

Establezca el valor resourceFiles.

Parámetros:

resourceFiles - valor resourceFiles que se va a establecer

Devoluciones:

El propio objeto StartTask.

withUserIdentity

public StartTask withUserIdentity(UserIdentity userIdentity)

Establezca si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea.

Parámetros:

userIdentity - valor userIdentity que se va a establecer

Devoluciones:

El propio objeto StartTask.

withWaitForSuccess

public StartTask withWaitForSuccess(Boolean waitForSuccess)

Establezca si es true y se produce un error en la tarea de inicio en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas se seguirán programando en el nodo. El valor predeterminado es true.

Parámetros:

waitForSuccess - El valor waitForSuccess que se va a establecer

Devoluciones:

El propio objeto StartTask.