Class Runnable.Container (0.41.0)

public static final class Runnable.Container extends GeneratedMessageV3 implements Runnable.ContainerOrBuilder

Container runnable.

Protobuf type google.cloud.batch.v1.Runnable.Container

Static Fields

BLOCK_EXTERNAL_NETWORK_FIELD_NUMBER

public static final int BLOCK_EXTERNAL_NETWORK_FIELD_NUMBER
Field Value
TypeDescription
int

COMMANDS_FIELD_NUMBER

public static final int COMMANDS_FIELD_NUMBER
Field Value
TypeDescription
int

ENABLE_IMAGE_STREAMING_FIELD_NUMBER

public static final int ENABLE_IMAGE_STREAMING_FIELD_NUMBER
Field Value
TypeDescription
int

ENTRYPOINT_FIELD_NUMBER

public static final int ENTRYPOINT_FIELD_NUMBER
Field Value
TypeDescription
int

IMAGE_URI_FIELD_NUMBER

public static final int IMAGE_URI_FIELD_NUMBER
Field Value
TypeDescription
int

OPTIONS_FIELD_NUMBER

public static final int OPTIONS_FIELD_NUMBER
Field Value
TypeDescription
int

PASSWORD_FIELD_NUMBER

public static final int PASSWORD_FIELD_NUMBER
Field Value
TypeDescription
int

USERNAME_FIELD_NUMBER

public static final int USERNAME_FIELD_NUMBER
Field Value
TypeDescription
int

VOLUMES_FIELD_NUMBER

public static final int VOLUMES_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static Runnable.Container getDefaultInstance()
Returns
TypeDescription
Runnable.Container

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static Runnable.Container.Builder newBuilder()
Returns
TypeDescription
Runnable.Container.Builder

newBuilder(Runnable.Container prototype)

public static Runnable.Container.Builder newBuilder(Runnable.Container prototype)
Parameter
NameDescription
prototypeRunnable.Container
Returns
TypeDescription
Runnable.Container.Builder

parseDelimitedFrom(InputStream input)

public static Runnable.Container parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static Runnable.Container parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Runnable.Container parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Runnable.Container parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static Runnable.Container parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static Runnable.Container parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Runnable.Container parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Runnable.Container
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<Runnable.Container> parser()
Returns
TypeDescription
Parser<Container>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getBlockExternalNetwork()

public boolean getBlockExternalNetwork()

If set to true, external network access to and from container will be blocked, containers that are with block_external_network as true can still communicate with each other, network cannot be specified in the container.options field.

bool block_external_network = 9;

Returns
TypeDescription
boolean

The blockExternalNetwork.

getCommands(int index)

public String getCommands(int index)

Overrides the CMD specified in the container. If there is an ENTRYPOINT (either in the container image or with the entrypoint field below) then commands are appended as arguments to the ENTRYPOINT.

repeated string commands = 2;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The commands at the given index.

getCommandsBytes(int index)

public ByteString getCommandsBytes(int index)

Overrides the CMD specified in the container. If there is an ENTRYPOINT (either in the container image or with the entrypoint field below) then commands are appended as arguments to the ENTRYPOINT.

repeated string commands = 2;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the commands at the given index.

getCommandsCount()

public int getCommandsCount()

Overrides the CMD specified in the container. If there is an ENTRYPOINT (either in the container image or with the entrypoint field below) then commands are appended as arguments to the ENTRYPOINT.

repeated string commands = 2;

Returns
TypeDescription
int

The count of commands.

getCommandsList()

public ProtocolStringList getCommandsList()

Overrides the CMD specified in the container. If there is an ENTRYPOINT (either in the container image or with the entrypoint field below) then commands are appended as arguments to the ENTRYPOINT.

repeated string commands = 2;

Returns
TypeDescription
ProtocolStringList

A list containing the commands.

getDefaultInstanceForType()

public Runnable.Container getDefaultInstanceForType()
Returns
TypeDescription
Runnable.Container

getEnableImageStreaming()

public boolean getEnableImageStreaming()

Optional. If set to true, this container runnable uses Image streaming.

Use Image streaming to allow the runnable to initialize without waiting for the entire container image to download, which can significantly reduce startup time for large container images.

When enableImageStreaming is set to true, the container runtime is containerd instead of Docker. Additionally, this container runnable only supports the following container subfields: imageUri, commands[], entrypoint, and volumes[]; any other container subfields are ignored.

For more information about the requirements and limitations for using Image streaming with Batch, see the image-streaming sample on GitHub.

bool enable_image_streaming = 12 [(.google.api.field_behavior) = OPTIONAL];

Returns
TypeDescription
boolean

The enableImageStreaming.

getEntrypoint()

public String getEntrypoint()

Overrides the ENTRYPOINT specified in the container.

string entrypoint = 3;

Returns
TypeDescription
String

The entrypoint.

getEntrypointBytes()

public ByteString getEntrypointBytes()

Overrides the ENTRYPOINT specified in the container.

string entrypoint = 3;

Returns
TypeDescription
ByteString

The bytes for entrypoint.

getImageUri()

public String getImageUri()

The URI to pull the container image from.

string image_uri = 1;

Returns
TypeDescription
String

The imageUri.

getImageUriBytes()

public ByteString getImageUriBytes()

The URI to pull the container image from.

string image_uri = 1;

Returns
TypeDescription
ByteString

The bytes for imageUri.

getOptions()

public String getOptions()

Arbitrary additional options to include in the "docker run" command when running this container, e.g. "--network host".

string options = 8;

Returns
TypeDescription
String

The options.

getOptionsBytes()

public ByteString getOptionsBytes()

Arbitrary additional options to include in the "docker run" command when running this container, e.g. "--network host".

string options = 8;

Returns
TypeDescription
ByteString

The bytes for options.

getParserForType()

public Parser<Runnable.Container> getParserForType()
Returns
TypeDescription
Parser<Container>
Overrides

getPassword()

public String getPassword()

Required if the container image is from a private Docker registry. The password to login to the Docker registry that contains the image.

For security, it is strongly recommended to specify an encrypted password by using a Secret Manager secret: projects/*/secrets/*/versions/*.

Warning: If you specify the password using plain text, you risk the password being exposed to any users who can view the job or its logs. To avoid this risk, specify a secret that contains the password instead.

Learn more about Secret Manager and using Secret Manager with Batch.

string password = 11;

Returns
TypeDescription
String

The password.

getPasswordBytes()

public ByteString getPasswordBytes()

Required if the container image is from a private Docker registry. The password to login to the Docker registry that contains the image.

For security, it is strongly recommended to specify an encrypted password by using a Secret Manager secret: projects/*/secrets/*/versions/*.

Warning: If you specify the password using plain text, you risk the password being exposed to any users who can view the job or its logs. To avoid this risk, specify a secret that contains the password instead.

Learn more about Secret Manager and using Secret Manager with Batch.

string password = 11;

Returns
TypeDescription
ByteString

The bytes for password.

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getUsername()

public String getUsername()

Required if the container image is from a private Docker registry. The username to login to the Docker registry that contains the image.

You can either specify the username directly by using plain text or specify an encrypted username by using a Secret Manager secret: projects/*/secrets/*/versions/*. However, using a secret is recommended for enhanced security.

Caution: If you specify the username using plain text, you risk the username being exposed to any users who can view the job or its logs. To avoid this risk, specify a secret that contains the username instead.

Learn more about Secret Manager and using Secret Manager with Batch.

string username = 10;

Returns
TypeDescription
String

The username.

getUsernameBytes()

public ByteString getUsernameBytes()

Required if the container image is from a private Docker registry. The username to login to the Docker registry that contains the image.

You can either specify the username directly by using plain text or specify an encrypted username by using a Secret Manager secret: projects/*/secrets/*/versions/*. However, using a secret is recommended for enhanced security.

Caution: If you specify the username using plain text, you risk the username being exposed to any users who can view the job or its logs. To avoid this risk, specify a secret that contains the username instead.

Learn more about Secret Manager and using Secret Manager with Batch.

string username = 10;

Returns
TypeDescription
ByteString

The bytes for username.

getVolumes(int index)

public String getVolumes(int index)

Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro

If the TaskSpec.Volumes field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (ro) for existing persistent disks and read-write (rw) for other volume types, regardless of the original mount options specified in TaskSpec.Volumes. If you need different mount settings, you can explicitly configure them in this field.

repeated string volumes = 7;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The volumes at the given index.

getVolumesBytes(int index)

public ByteString getVolumesBytes(int index)

Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro

If the TaskSpec.Volumes field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (ro) for existing persistent disks and read-write (rw) for other volume types, regardless of the original mount options specified in TaskSpec.Volumes. If you need different mount settings, you can explicitly configure them in this field.

repeated string volumes = 7;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the volumes at the given index.

getVolumesCount()

public int getVolumesCount()

Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro

If the TaskSpec.Volumes field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (ro) for existing persistent disks and read-write (rw) for other volume types, regardless of the original mount options specified in TaskSpec.Volumes. If you need different mount settings, you can explicitly configure them in this field.

repeated string volumes = 7;

Returns
TypeDescription
int

The count of volumes.

getVolumesList()

public ProtocolStringList getVolumesList()

Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro

If the TaskSpec.Volumes field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (ro) for existing persistent disks and read-write (rw) for other volume types, regardless of the original mount options specified in TaskSpec.Volumes. If you need different mount settings, you can explicitly configure them in this field.

repeated string volumes = 7;

Returns
TypeDescription
ProtocolStringList

A list containing the volumes.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public Runnable.Container.Builder newBuilderForType()
Returns
TypeDescription
Runnable.Container.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Runnable.Container.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
Runnable.Container.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public Runnable.Container.Builder toBuilder()
Returns
TypeDescription
Runnable.Container.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException