Google Cloud Batch V1 Client - Class Runnable (1.1.5)

Version latest

• 1.1.5 (latest)
• 1.1.4
• 1.0.3
• 0.17.0
• 0.16.10
• 0.15.0
• 0.14.0
• 0.13.1
• 0.12.1
• 0.11.3
• 0.10.0
• 0.9.0
• 0.8.0
• 0.7.0
• 0.6.0
• 0.5.2
• 0.4.0
• 0.3.0
• 0.2.2

Reference documentation and code samples for the Google Cloud Batch V1 Client class Runnable.

Runnable describes instructions for executing a specific script or container as part of a Task.

Generated from protobuf message google.cloud.batch.v1.Runnable

Namespace

Google \ Cloud \ Batch \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ container	Runnable\Container Container runnable.
↳ script	Runnable\Script Script runnable.
↳ barrier	Runnable\Barrier Barrier runnable.
↳ display_name	string Optional. DisplayName is an optional field that can be provided by the caller. If provided, it will be used in logs and other outputs to identify the script, making it easier for users to understand the logs. If not provided the index of the runnable will be used for outputs.
↳ ignore_exit_status	bool Normally, a runnable that returns a non-zero exit status fails and causes the task to fail. However, you can set this field to true to allow the task to continue executing its other runnables even if this runnable fails.
↳ background	bool Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field to true to configure a background runnable. Background runnables are allowed continue running in the background while the task executes subsequent runnables. For example, background runnables are useful for providing services to other runnables or providing debugging-support tools like SSH servers. Specifically, background runnables are killed automatically (if they have not already exited) a short time after all foreground runnables have completed. Even though this is likely to result in a non-zero exit status for the background runnable, these automatic kills are not treated as task failures.
↳ always_run	bool By default, after a Runnable fails, no further Runnable are executed. This flag indicates that this Runnable must be run even if the Task has already failed. This is useful for Runnables that copy output files off of the VM or for debugging. The always_run flag does not override the Task's overall max_run_duration. If the max_run_duration has expired then no further Runnables will execute, not even always_run Runnables.
↳ environment	Environment Environment variables for this Runnable (overrides variables set for the whole Task or TaskGroup).
↳ timeout	Google\Protobuf\Duration Timeout for this Runnable.
↳ labels	array|Google\Protobuf\Internal\MapField Labels for this Runnable.

getContainer

Container runnable.

Returns
Type	Description
Runnable\Container|null

hasContainer

setContainer

Container runnable.

Parameter
Name	Description
var	Runnable\Container

Returns
Type	Description
$this

getScript

Script runnable.

Returns
Type	Description
Runnable\Script|null

hasScript

setScript

Script runnable.

Parameter
Name	Description
var	Runnable\Script

Returns
Type	Description
$this

getBarrier

Barrier runnable.

Returns
Type	Description
Runnable\Barrier|null

hasBarrier

setBarrier

Barrier runnable.

Parameter
Name	Description
var	Runnable\Barrier

Returns
Type	Description
$this

getDisplayName

Optional. DisplayName is an optional field that can be provided by the caller. If provided, it will be used in logs and other outputs to identify the script, making it easier for users to understand the logs. If not provided the index of the runnable will be used for outputs.

Returns
Type	Description
string

setDisplayName

Optional. DisplayName is an optional field that can be provided by the caller. If provided, it will be used in logs and other outputs to identify the script, making it easier for users to understand the logs. If not provided the index of the runnable will be used for outputs.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getIgnoreExitStatus

Normally, a runnable that returns a non-zero exit status fails and causes the task to fail. However, you can set this field to true to allow the task to continue executing its other runnables even if this runnable fails.

Returns
Type	Description
bool

setIgnoreExitStatus

Normally, a runnable that returns a non-zero exit status fails and causes the task to fail. However, you can set this field to true to allow the task to continue executing its other runnables even if this runnable fails.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getBackground

Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field to true to configure a background runnable.

Background runnables are allowed continue running in the background while the task executes subsequent runnables. For example, background runnables are useful for providing services to other runnables or providing debugging-support tools like SSH servers. Specifically, background runnables are killed automatically (if they have not already exited) a short time after all foreground runnables have completed. Even though this is likely to result in a non-zero exit status for the background runnable, these automatic kills are not treated as task failures.

Returns
Type	Description
bool

setBackground

Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field to true to configure a background runnable.

Background runnables are allowed continue running in the background while the task executes subsequent runnables. For example, background runnables are useful for providing services to other runnables or providing debugging-support tools like SSH servers. Specifically, background runnables are killed automatically (if they have not already exited) a short time after all foreground runnables have completed. Even though this is likely to result in a non-zero exit status for the background runnable, these automatic kills are not treated as task failures.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getAlwaysRun

By default, after a Runnable fails, no further Runnable are executed. This flag indicates that this Runnable must be run even if the Task has already failed. This is useful for Runnables that copy output files off of the VM or for debugging.

The always_run flag does not override the Task's overall max_run_duration. If the max_run_duration has expired then no further Runnables will execute, not even always_run Runnables.

Returns
Type	Description
bool

setAlwaysRun

By default, after a Runnable fails, no further Runnable are executed. This flag indicates that this Runnable must be run even if the Task has already failed. This is useful for Runnables that copy output files off of the VM or for debugging.

The always_run flag does not override the Task's overall max_run_duration. If the max_run_duration has expired then no further Runnables will execute, not even always_run Runnables.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getEnvironment

Environment variables for this Runnable (overrides variables set for the whole Task or TaskGroup).

Returns
Type	Description
Environment|null

hasEnvironment

clearEnvironment

setEnvironment

Environment variables for this Runnable (overrides variables set for the whole Task or TaskGroup).

Parameter
Name	Description
var	Environment

Returns
Type	Description
$this

getTimeout

Timeout for this Runnable.

Returns
Type	Description
Google\Protobuf\Duration|null

hasTimeout

clearTimeout

setTimeout

Timeout for this Runnable.

Parameter
Name	Description
var	Google\Protobuf\Duration

Returns
Type	Description
$this

getLabels

Labels for this Runnable.

Returns
Type	Description
Google\Protobuf\Internal\MapField

setLabels

Labels for this Runnable.

Parameter
Name	Description
var	array|Google\Protobuf\Internal\MapField

Returns
Type	Description
$this

getExecutable

Returns
Type	Description
string