Package software.amazon.awssdk.services.batch.model

Interface TaskContainerProperties.Builder

All Superinterfaces:
Buildable, CopyableBuilder<TaskContainerProperties.Builder,TaskContainerProperties>, SdkBuilder<TaskContainerProperties.Builder,TaskContainerProperties>, SdkPojo
Enclosing class:
TaskContainerProperties
public static interface TaskContainerProperties.Builder extends SdkPojo, CopyableBuilder<TaskContainerProperties.Builder,TaskContainerProperties>

  • Method Details

    • command

      TaskContainerProperties.Builder command(Collection<String> command)

      The command that's passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see Dockerfile reference: CMD.

      Parameters:
      command - The command that's passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see Dockerfile reference: CMD.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • command

      TaskContainerProperties.Builder command(String... command)

      The command that's passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see Dockerfile reference: CMD.

      Parameters:
      command - The command that's passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see Dockerfile reference: CMD.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • dependsOn

      TaskContainerProperties.Builder dependsOn(Collection<TaskContainerDependency> dependsOn)

      A list of containers that this container depends on.

      Parameters:
      dependsOn - A list of containers that this container depends on.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • dependsOn

      TaskContainerProperties.Builder dependsOn(TaskContainerDependency... dependsOn)

      A list of containers that this container depends on.

      Parameters:
      dependsOn - A list of containers that this container depends on.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • dependsOn

      TaskContainerProperties.Builder dependsOn(Consumer<TaskContainerDependency.Builder>... dependsOn)

      A list of containers that this container depends on.

      This is a convenience method that creates an instance of the TaskContainerDependency.Builder avoiding the need to create one manually via TaskContainerDependency.builder() .

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to dependsOn(List<TaskContainerDependency>).

      Parameters:
      dependsOn - a consumer that will call methods on TaskContainerDependency.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • environment

      TaskContainerProperties.Builder environment(Collection<KeyValuePair> environment)

      The environment variables to pass to a container. This parameter maps to Env inthe Create a container section of the Docker Remote API and the --env parameter to docker run.

      We don't recommend using plaintext environment variables for sensitive information, such as credential data.

      Environment variables cannot start with AWS_BATCH. This naming convention is reserved for variables that Batch sets.

      Parameters:
      environment - The environment variables to pass to a container. This parameter maps to Env inthe Create a container section of the Docker Remote API and the --env parameter to docker run.

      We don't recommend using plaintext environment variables for sensitive information, such as credential data.

      Environment variables cannot start with AWS_BATCH. This naming convention is reserved for variables that Batch sets.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • environment

      TaskContainerProperties.Builder environment(KeyValuePair... environment)

      The environment variables to pass to a container. This parameter maps to Env inthe Create a container section of the Docker Remote API and the --env parameter to docker run.

      We don't recommend using plaintext environment variables for sensitive information, such as credential data.

      Environment variables cannot start with AWS_BATCH. This naming convention is reserved for variables that Batch sets.

      Parameters:
      environment - The environment variables to pass to a container. This parameter maps to Env inthe Create a container section of the Docker Remote API and the --env parameter to docker run.

      We don't recommend using plaintext environment variables for sensitive information, such as credential data.

      Environment variables cannot start with AWS_BATCH. This naming convention is reserved for variables that Batch sets.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • environment

      TaskContainerProperties.Builder environment(Consumer<KeyValuePair.Builder>... environment)

      The environment variables to pass to a container. This parameter maps to Env inthe Create a container section of the Docker Remote API and the --env parameter to docker run.

      We don't recommend using plaintext environment variables for sensitive information, such as credential data.

      Environment variables cannot start with AWS_BATCH. This naming convention is reserved for variables that Batch sets.

      This is a convenience method that creates an instance of the KeyValuePair.Builder avoiding the need to create one manually via KeyValuePair.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to environment(List<KeyValuePair>).

      Parameters:
      environment - a consumer that will call methods on KeyValuePair.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • essential

      TaskContainerProperties.Builder essential(Boolean essential)

      If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, its failure doesn't affect the rest of the containers in a task. If this parameter is omitted, a container is assumed to be essential.

      All jobs must have at least one essential container. If you have an application that's composed of multiple containers, group containers that are used for a common purpose into components, and separate the different components into multiple task definitions. For more information, see Application Architecture in the Amazon Elastic Container Service Developer Guide.

      Parameters:
      essential - If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, its failure doesn't affect the rest of the containers in a task. If this parameter is omitted, a container is assumed to be essential.

      All jobs must have at least one essential container. If you have an application that's composed of multiple containers, group containers that are used for a common purpose into components, and separate the different components into multiple task definitions. For more information, see Application Architecture in the Amazon Elastic Container Service Developer Guide.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • image

      TaskContainerProperties.Builder image(String image)

      The image used to start a container. This string is passed directly to the Docker daemon. By default, images in the Docker Hub registry are available. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest. Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed. This parameter maps to Image in the Create a container section of the Docker Remote API and the IMAGE parameter of the docker run .

      Parameters:
      image - The image used to start a container. This string is passed directly to the Docker daemon. By default, images in the Docker Hub registry are available. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest. Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed. This parameter maps to Image in the Create a container section of the Docker Remote API and the IMAGE parameter of the docker run .
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • linuxParameters

      TaskContainerProperties.Builder linuxParameters(LinuxParameters linuxParameters)

      Linux-specific modifications that are applied to the container, such as Linux kernel capabilities. For more information, see KernelCapabilities.

      Parameters:
      linuxParameters - Linux-specific modifications that are applied to the container, such as Linux kernel capabilities. For more information, see KernelCapabilities.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • linuxParameters

      default TaskContainerProperties.Builder linuxParameters(Consumer<LinuxParameters.Builder> linuxParameters)

      Linux-specific modifications that are applied to the container, such as Linux kernel capabilities. For more information, see KernelCapabilities.

      This is a convenience method that creates an instance of the LinuxParameters.Builder avoiding the need to create one manually via LinuxParameters.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to linuxParameters(LinuxParameters).

      Parameters:
      linuxParameters - a consumer that will call methods on LinuxParameters.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • logConfiguration

      TaskContainerProperties.Builder logConfiguration(LogConfiguration logConfiguration)

      The log configuration specification for the container.

      This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run.

      By default, containers use the same logging driver that the Docker daemon uses. However the container can use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information about the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

      Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the LogConfiguration data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS environment variable before containers placed on that instance can use these log configuration options. For more information, see Amazon ECS container agent configuration in the Amazon Elastic Container Service Developer Guide.

      Parameters:
      logConfiguration - The log configuration specification for the container.

      This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run.

      By default, containers use the same logging driver that the Docker daemon uses. However the container can use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information about the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

      Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the LogConfiguration data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS environment variable before containers placed on that instance can use these log configuration options. For more information, see Amazon ECS container agent configuration in the Amazon Elastic Container Service Developer Guide.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • logConfiguration

      default TaskContainerProperties.Builder logConfiguration(Consumer<LogConfiguration.Builder> logConfiguration)

      The log configuration specification for the container.

      This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run.

      By default, containers use the same logging driver that the Docker daemon uses. However the container can use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information about the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

      Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the LogConfiguration data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS environment variable before containers placed on that instance can use these log configuration options. For more information, see Amazon ECS container agent configuration in the Amazon Elastic Container Service Developer Guide.

      This is a convenience method that creates an instance of the LogConfiguration.Builder avoiding the need to create one manually via LogConfiguration.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to logConfiguration(LogConfiguration).

      Parameters:
      logConfiguration - a consumer that will call methods on LogConfiguration.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • mountPoints

      TaskContainerProperties.Builder mountPoints(Collection<MountPoint> mountPoints)

      The mount points for data volumes in your container.

      This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

      Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

      Parameters:
      mountPoints - The mount points for data volumes in your container.

      This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

      Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • mountPoints

      TaskContainerProperties.Builder mountPoints(MountPoint... mountPoints)

      The mount points for data volumes in your container.

      This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

      Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

      Parameters:
      mountPoints - The mount points for data volumes in your container.

      This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

      Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • mountPoints

      TaskContainerProperties.Builder mountPoints(Consumer<MountPoint.Builder>... mountPoints)

      The mount points for data volumes in your container.

      This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

      Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

      This is a convenience method that creates an instance of the MountPoint.Builder avoiding the need to create one manually via MountPoint.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to mountPoints(List<MountPoint>).

      Parameters:
      mountPoints - a consumer that will call methods on MountPoint.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • name

      TaskContainerProperties.Builder name(String name)

      The name of a container. The name can be used as a unique identifier to target your dependsOn and Overrides objects.

      Parameters:
      name - The name of a container. The name can be used as a unique identifier to target your dependsOn and Overrides objects.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • privileged

      TaskContainerProperties.Builder privileged(Boolean privileged)

      When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user). This parameter maps to Privileged in the Create a container section of the Docker Remote API and the --privileged option to docker run.

      This parameter is not supported for Windows containers or tasks run on Fargate.

      Parameters:
      privileged - When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user). This parameter maps to Privileged in the Create a container section of the Docker Remote API and the --privileged option to docker run.

      This parameter is not supported for Windows containers or tasks run on Fargate.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • readonlyRootFilesystem

      TaskContainerProperties.Builder readonlyRootFilesystem(Boolean readonlyRootFilesystem)

      When this parameter is true, the container is given read-only access to its root file system. This parameter maps to ReadonlyRootfs in the Create a container section of the Docker Remote API and the --read-only option to docker run.

      This parameter is not supported for Windows containers.

      Parameters:
      readonlyRootFilesystem - When this parameter is true, the container is given read-only access to its root file system. This parameter maps to ReadonlyRootfs in the Create a container section of the Docker Remote API and the --read-only option to docker run.

      This parameter is not supported for Windows containers.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • repositoryCredentials

      TaskContainerProperties.Builder repositoryCredentials(RepositoryCredentials repositoryCredentials)

      The private repository authentication credentials to use.

      Parameters:
      repositoryCredentials - The private repository authentication credentials to use.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • repositoryCredentials

      default TaskContainerProperties.Builder repositoryCredentials(Consumer<RepositoryCredentials.Builder> repositoryCredentials)

      The private repository authentication credentials to use.

      This is a convenience method that creates an instance of the RepositoryCredentials.Builder avoiding the need to create one manually via RepositoryCredentials.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to repositoryCredentials(RepositoryCredentials).

      Parameters:
      repositoryCredentials - a consumer that will call methods on RepositoryCredentials.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • resourceRequirements

      TaskContainerProperties.Builder resourceRequirements(Collection<ResourceRequirement> resourceRequirements)

      The type and amount of a resource to assign to a container. The only supported resource is a GPU.

      Parameters:
      resourceRequirements - The type and amount of a resource to assign to a container. The only supported resource is a GPU.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • resourceRequirements

      TaskContainerProperties.Builder resourceRequirements(ResourceRequirement... resourceRequirements)

      The type and amount of a resource to assign to a container. The only supported resource is a GPU.

      Parameters:
      resourceRequirements - The type and amount of a resource to assign to a container. The only supported resource is a GPU.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • resourceRequirements

      TaskContainerProperties.Builder resourceRequirements(Consumer<ResourceRequirement.Builder>... resourceRequirements)

      The type and amount of a resource to assign to a container. The only supported resource is a GPU.

      This is a convenience method that creates an instance of the ResourceRequirement.Builder avoiding the need to create one manually via ResourceRequirement.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to resourceRequirements(List<ResourceRequirement>).

      Parameters:
      resourceRequirements - a consumer that will call methods on ResourceRequirement.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • secrets

      TaskContainerProperties.Builder secrets(Collection<Secret> secrets)

      The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.

      Parameters:
      secrets - The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • secrets

      TaskContainerProperties.Builder secrets(Secret... secrets)

      The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.

      Parameters:
      secrets - The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • secrets

      TaskContainerProperties.Builder secrets(Consumer<Secret.Builder>... secrets)

      The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.

      This is a convenience method that creates an instance of the Secret.Builder avoiding the need to create one manually via Secret.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to secrets(List<Secret>).

      Parameters:
      secrets - a consumer that will call methods on Secret.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • ulimits

      TaskContainerProperties.Builder ulimits(Collection<Ulimit> ulimits)

      A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

      Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      This parameter is not supported for Windows containers.

      Parameters:
      ulimits - A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

      Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      This parameter is not supported for Windows containers.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • ulimits

      TaskContainerProperties.Builder ulimits(Ulimit... ulimits)

      A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

      Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      This parameter is not supported for Windows containers.

      Parameters:
      ulimits - A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

      Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      This parameter is not supported for Windows containers.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • ulimits

      TaskContainerProperties.Builder ulimits(Consumer<Ulimit.Builder>... ulimits)

      A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run.

      Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

      This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

      This parameter is not supported for Windows containers.

      This is a convenience method that creates an instance of the Ulimit.Builder avoiding the need to create one manually via Ulimit.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to ulimits(List<Ulimit>).

      Parameters:
      ulimits - a consumer that will call methods on Ulimit.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • user

      TaskContainerProperties.Builder user(String user)

      The user to use inside the container. This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

      When running tasks using the host network mode, don't run containers using the root user (UID 0). We recommend using a non-root user for better security.

      You can specify the user using the following formats. If specifying a UID or GID, you must specify it as a positive integer.

      • user

      • user:group

      • uid

      • uid:gid

      • user:gi

      • uid:group

      This parameter is not supported for Windows containers.

      Parameters:
      user - The user to use inside the container. This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

      When running tasks using the host network mode, don't run containers using the root user (UID 0). We recommend using a non-root user for better security.

      You can specify the user using the following formats. If specifying a UID or GID, you must specify it as a positive integer.

      • user

      • user:group

      • uid

      • uid:gid

      • user:gi

      • uid:group

      This parameter is not supported for Windows containers.

      Returns:
      Returns a reference to this object so that method calls can be chained together.