public sealed class Runnable : IMessage<Runnable>, IEquatable<Runnable>, IDeepCloneable<Runnable>, IBufferMessage, IMessage
Reference documentation and code samples for the Batch v1 API class Runnable.
Runnable describes instructions for executing a specific script or container as part of a Task.
Namespace
Google.Cloud.Batch.V1Assembly
Google.Cloud.Batch.V1.dll
Constructors
Runnable()
public Runnable()
Runnable(Runnable)
public Runnable(Runnable other)
Parameter | |
---|---|
Name | Description |
other |
Runnable |
Properties
AlwaysRun
public bool AlwaysRun { get; set; }
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.
Property Value | |
---|---|
Type | Description |
bool |
Background
public bool Background { get; set; }
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.
Property Value | |
---|---|
Type | Description |
bool |
Barrier
public Runnable.Types.Barrier Barrier { get; set; }
Barrier runnable.
Property Value | |
---|---|
Type | Description |
RunnableTypesBarrier |
Container
public Runnable.Types.Container Container { get; set; }
Container runnable.
Property Value | |
---|---|
Type | Description |
RunnableTypesContainer |
DisplayName
public string DisplayName { get; set; }
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.
Property Value | |
---|---|
Type | Description |
string |
Environment
public Environment Environment { get; set; }
Environment variables for this Runnable (overrides variables set for the whole Task or TaskGroup).
Property Value | |
---|---|
Type | Description |
Environment |
ExecutableCase
public Runnable.ExecutableOneofCase ExecutableCase { get; }
Property Value | |
---|---|
Type | Description |
RunnableExecutableOneofCase |
IgnoreExitStatus
public bool IgnoreExitStatus { get; set; }
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.
Property Value | |
---|---|
Type | Description |
bool |
Labels
public MapField<string, string> Labels { get; }
Labels for this Runnable.
Property Value | |
---|---|
Type | Description |
MapFieldstringstring |
Script
public Runnable.Types.Script Script { get; set; }
Script runnable.
Property Value | |
---|---|
Type | Description |
RunnableTypesScript |
Timeout
public Duration Timeout { get; set; }
Timeout for this Runnable.
Property Value | |
---|---|
Type | Description |
Duration |