View Source Dagger.Container (dagger v0.12.7)
An OCI-compatible container, also known as a Docker container.
Summary
Functions
Turn the container into a Service.
Returns a File representing the container serialized to a tarball.
Initializes this container from a Dockerfile build.
Retrieves default arguments for future commands.
Retrieves a directory at the given path.
Retrieves entrypoint to be prepended to the arguments of all commands.
Retrieves the value of the specified environment variable.
Retrieves the list of environment variables passed to commands.
EXPERIMENTAL API! Subject to change/removal at any time.
EXPERIMENTAL API! Subject to change/removal at any time.
Writes the container as an OCI tarball to the destination file path on the host.
Retrieves the list of exposed ports.
Retrieves a file at the given path.
Initializes this container from a pulled base image.
A unique identifier for this Container.
The unique image reference which can only be retrieved immediately after the 'Container.From' call.
Reads the container from an OCI tarball.
Retrieves the value of the specified label.
Retrieves the list of labels passed to container.
Retrieves the list of paths where a directory is mounted.
Creates a named sub-pipeline.
The platform this container executes and publishes as.
Publishes this container as a new image to the specified address.
Retrieves this container's root filesystem. Mounts are not included.
The error stream of the last executed command.
The output stream of the last executed command.
Forces evaluation of the pipeline in the engine.
Opens an interactive terminal for this container using its configured default terminal command if not overridden by args (or sh as a fallback default).
Retrieves the user to be set for all commands.
Configures default arguments for future commands.
Set the default command to invoke for the container's terminal API.
Retrieves this container plus a directory written at the given path.
Retrieves this container but with a different command entrypoint.
Retrieves this container plus the given environment variable.
Retrieves this container after executing the specified command inside it.
Expose a network port.
Retrieves this container plus the contents of the given file copied to the given path.
Retrieves this container plus the contents of the given files copied to the given path.
Indicate that subsequent operations should be featured more prominently in the UI.
Retrieves this container plus the given label.
Retrieves this container plus a cache volume mounted at the given path.
Retrieves this container plus a directory mounted at the given path.
Retrieves this container plus a file mounted at the given path.
Retrieves this container plus a secret mounted into a file at the given path.
Retrieves this container plus a temporary directory mounted at the given path. Any writes will be ephemeral to a single withExec call; they will not be persisted to subsequent withExecs.
Retrieves this container plus a new file written at the given path.
Retrieves this container with a registry authentication for a given address.
Retrieves the container with the given directory mounted to /.
Retrieves this container plus an env variable containing the given secret.
Establish a runtime dependency on a service.
Retrieves this container plus a socket forwarded to the given Unix socket path.
Retrieves this container with a different command user.
Retrieves this container with a different working directory.
Retrieves this container with unset default arguments for future commands.
Retrieves this container with the directory at the given path removed.
Retrieves this container with an unset command entrypoint.
Retrieves this container minus the given environment variable.
Unexpose a previously exposed port.
Retrieves this container with the file at the given path removed.
Indicate that subsequent operations should not be featured more prominently in the UI.
Retrieves this container minus the given environment label.
Retrieves this container after unmounting everything at the given path.
Retrieves this container without the registry authentication of a given address.
Retrieves this container minus the given environment variable containing the secret.
Retrieves this container with a previously added Unix socket removed.
Retrieves this container with an unset command user.
Retrieves this container with an unset working directory.
Retrieves the working directory for all commands.
Types
Functions
@spec as_service(t()) :: Dagger.Service.t()
Turn the container into a Service.
Be sure to set any exposed ports before this conversion.
@spec as_tarball(t(), platform_variants: [Dagger.ContainerID.t()], forced_compression: Dagger.ImageLayerCompression.t() | nil, media_types: Dagger.ImageMediaTypes.t() | nil ) :: Dagger.File.t()
Returns a File representing the container serialized to a tarball.
@spec build(t(), Dagger.Directory.t(), dockerfile: String.t() | nil, target: String.t() | nil, build_args: [Dagger.BuildArg.t()], secrets: [Dagger.SecretID.t()] ) :: t()
Initializes this container from a Dockerfile build.
Retrieves default arguments for future commands.
@spec directory(t(), String.t()) :: Dagger.Directory.t()
Retrieves a directory at the given path.
Mounts are included.
Retrieves entrypoint to be prepended to the arguments of all commands.
Retrieves the value of the specified environment variable.
@spec env_variables(t()) :: {:ok, [Dagger.EnvVariable.t()]} | {:error, term()}
Retrieves the list of environment variables passed to commands.
EXPERIMENTAL API! Subject to change/removal at any time.
Configures all available GPUs on the host to be accessible to this container.
This currently works for Nvidia devices only.
EXPERIMENTAL API! Subject to change/removal at any time.
Configures the provided list of devices to be accessible to this container.
This currently works for Nvidia devices only.
@spec export(t(), String.t(), platform_variants: [Dagger.ContainerID.t()], forced_compression: Dagger.ImageLayerCompression.t() | nil, media_types: Dagger.ImageMediaTypes.t() | nil ) :: {:ok, String.t()} | {:error, term()}
Writes the container as an OCI tarball to the destination file path on the host.
It can also export platform variants.
@spec exposed_ports(t()) :: {:ok, [Dagger.Port.t()]} | {:error, term()}
Retrieves the list of exposed ports.
This includes ports already exposed by the image, even if not explicitly added with dagger.
@spec file(t(), String.t()) :: Dagger.File.t()
Retrieves a file at the given path.
Mounts are included.
Initializes this container from a pulled base image.
@spec id(t()) :: {:ok, Dagger.ContainerID.t()} | {:error, term()}
A unique identifier for this Container.
The unique image reference which can only be retrieved immediately after the 'Container.From' call.
@spec import(t(), Dagger.File.t(), [{:tag, String.t() | nil}]) :: t()
Reads the container from an OCI tarball.
Retrieves the value of the specified label.
@spec labels(t()) :: {:ok, [Dagger.Label.t()]} | {:error, term()}
Retrieves the list of labels passed to container.
Retrieves the list of paths where a directory is mounted.
@spec pipeline(t(), String.t(), description: String.t() | nil, labels: [Dagger.PipelineLabel.t()] ) :: t()
Creates a named sub-pipeline.
@spec platform(t()) :: {:ok, Dagger.Platform.t()} | {:error, term()}
The platform this container executes and publishes as.
@spec publish(t(), String.t(), platform_variants: [Dagger.ContainerID.t()], forced_compression: Dagger.ImageLayerCompression.t() | nil, media_types: Dagger.ImageMediaTypes.t() | nil ) :: {:ok, String.t()} | {:error, term()}
Publishes this container as a new image to the specified address.
Publish returns a fully qualified ref.
It can also publish platform variants.
@spec rootfs(t()) :: Dagger.Directory.t()
Retrieves this container's root filesystem. Mounts are not included.
The error stream of the last executed command.
Will execute default command if none is set, or error if there's no default.
The output stream of the last executed command.
Will execute default command if none is set, or error if there's no default.
Forces evaluation of the pipeline in the engine.
It doesn't run the default command if no exec has been set.
@spec terminal(t(), cmd: [String.t()], experimental_privileged_nesting: boolean() | nil, insecure_root_capabilities: boolean() | nil ) :: t()
Opens an interactive terminal for this container using its configured default terminal command if not overridden by args (or sh as a fallback default).
Retrieves the user to be set for all commands.
Configures default arguments for future commands.
@spec with_default_terminal_cmd( t(), [String.t()], experimental_privileged_nesting: boolean() | nil, insecure_root_capabilities: boolean() | nil ) :: t()
Set the default command to invoke for the container's terminal API.
@spec with_directory(t(), String.t(), Dagger.Directory.t(), exclude: [String.t()], include: [String.t()], owner: String.t() | nil ) :: t()
Retrieves this container plus a directory written at the given path.
Retrieves this container but with a different command entrypoint.
Retrieves this container plus the given environment variable.
@spec with_exec( t(), [String.t()], skip_entrypoint: boolean() | nil, use_entrypoint: boolean() | nil, stdin: String.t() | nil, redirect_stdout: String.t() | nil, redirect_stderr: String.t() | nil, experimental_privileged_nesting: boolean() | nil, insecure_root_capabilities: boolean() | nil ) :: t()
Retrieves this container after executing the specified command inside it.
@spec with_exposed_port(t(), integer(), protocol: Dagger.NetworkProtocol.t() | nil, description: String.t() | nil, experimental_skip_healthcheck: boolean() | nil ) :: t()
Expose a network port.
Exposed ports serve two purposes:
For health checks and introspection, when running services
For setting the EXPOSE OCI field when publishing the container
@spec with_file(t(), String.t(), Dagger.File.t(), permissions: integer() | nil, owner: String.t() | nil ) :: t()
Retrieves this container plus the contents of the given file copied to the given path.
@spec with_files(t(), String.t(), [Dagger.FileID.t()], permissions: integer() | nil, owner: String.t() | nil ) :: t()
Retrieves this container plus the contents of the given files copied to the given path.
Indicate that subsequent operations should be featured more prominently in the UI.
Retrieves this container plus the given label.
@spec with_mounted_cache(t(), String.t(), Dagger.CacheVolume.t(), source: Dagger.DirectoryID.t() | nil, sharing: Dagger.CacheSharingMode.t() | nil, owner: String.t() | nil ) :: t()
Retrieves this container plus a cache volume mounted at the given path.
with_mounted_directory(container, path, source, optional_args \\ [])
View Source@spec with_mounted_directory(t(), String.t(), Dagger.Directory.t(), [ {:owner, String.t() | nil} ]) :: t()
Retrieves this container plus a directory mounted at the given path.
@spec with_mounted_file(t(), String.t(), Dagger.File.t(), [{:owner, String.t() | nil}]) :: t()
Retrieves this container plus a file mounted at the given path.
@spec with_mounted_secret(t(), String.t(), Dagger.Secret.t(), owner: String.t() | nil, mode: integer() | nil ) :: t()
Retrieves this container plus a secret mounted into a file at the given path.
Retrieves this container plus a temporary directory mounted at the given path. Any writes will be ephemeral to a single withExec call; they will not be persisted to subsequent withExecs.
@spec with_new_file(t(), String.t(), String.t(), permissions: integer() | nil, owner: String.t() | nil ) :: t()
Retrieves this container plus a new file written at the given path.
@spec with_registry_auth(t(), String.t(), String.t(), Dagger.Secret.t()) :: t()
Retrieves this container with a registry authentication for a given address.
@spec with_rootfs(t(), Dagger.Directory.t()) :: t()
Retrieves the container with the given directory mounted to /.
@spec with_secret_variable(t(), String.t(), Dagger.Secret.t()) :: t()
Retrieves this container plus an env variable containing the given secret.
@spec with_service_binding(t(), String.t(), Dagger.Service.t()) :: t()
Establish a runtime dependency on a service.
The service will be started automatically when needed and detached when it is no longer needed, executing the default command if none is set.
The service will be reachable from the container via the provided hostname alias.
The service dependency will also convey to any files or directories produced by the container.
@spec with_unix_socket(t(), String.t(), Dagger.Socket.t(), [ {:owner, String.t() | nil} ]) :: t()
Retrieves this container plus a socket forwarded to the given Unix socket path.
Retrieves this container with a different command user.
Retrieves this container with a different working directory.
Retrieves this container with unset default arguments for future commands.
Retrieves this container with the directory at the given path removed.
Retrieves this container with an unset command entrypoint.
Retrieves this container minus the given environment variable.
@spec without_exposed_port(t(), integer(), [ {:protocol, Dagger.NetworkProtocol.t() | nil} ]) :: t()
Unexpose a previously exposed port.
Retrieves this container with the file at the given path removed.
Indicate that subsequent operations should not be featured more prominently in the UI.
This is the initial state of all containers.
Retrieves this container minus the given environment label.
Retrieves this container after unmounting everything at the given path.
Retrieves this container without the registry authentication of a given address.
Retrieves this container minus the given environment variable containing the secret.
Retrieves this container with a previously added Unix socket removed.
Retrieves this container with an unset command user.
Should default to root.
Retrieves this container with an unset working directory.
Should default to "/".
Retrieves the working directory for all commands.