docker-virt/dev.ust.zinc.grader.virtualization.docker/DockerDaemon/Unbound

Unbound

class Unbound(val hostname: String) : DockerDaemon

An unbounded instance of DockerDaemon is a daemon which does not declare resource reservations nor is strictly bound to a task.

Unbounded daemons only expose the low-level Docker APIs for usage. As such, these daemons cannot be used in virtualized environment abstraction APIs.

The intended use-case for unbounded daemons are when Docker engines are needed for tasks which do not require resource reservation, or tasks which are agnostic to individual Docker engines.

Unbounded daemons can be replicated via unboundInstance. However, unbounded daemons cannot be converted into bound daemons, due to the inability to bind to tasks or reserve resources.

There is no need to unbind unbounded daemons after use.

Constructors

constructor(hostname: String)

Properties

val boundInstance: DockerDaemon.Bound

Retrieves a bound instance of DockerDaemon.

open override val containerApi: DockerContainerApi

val hostname: String

Host name to the Docker engine.

open override val imageApi: DockerImageApi

protected open override val instance: DockerClient

A DockerClient instance which connects to the host of this DockerDaemon.

val isConnected: Boolean

protected val logger: Logger

unboundInstance

val unboundInstance: DockerDaemon.Unbound

Retrieves an unbound instance of DockerDaemon.

open override val volumeApi: DockerVolumeApi

Functions

open override fun toString(): String

fun <R> withInstance(block: DockerClient.() -> R): R

Executes block using a new instance of DockerClient, automatically closing the client after the block has exited.

withInstanceSuspending

suspend fun <R> withInstanceSuspending(context: CoroutineContext? = null, block: suspend DockerClient.() -> R): R

Executes block using a new instance of DockerClient, automatically closing the client after the block has exited.