@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.

@spec default_args(t()) :: {:ok, [String.t()]} | {:error, term()}

Retrieves default arguments for future commands.

@spec directory(t(), String.t()) :: Dagger.Directory.t()

Retrieves a directory at the given path.

Mounts are included.

@spec entrypoint(t()) :: {:ok, [String.t()]} | {:error, term()}

Retrieves entrypoint to be prepended to the arguments of all commands.

@spec env_variable(t(), String.t()) :: {:ok, String.t() | nil} | {:error, term()}

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.

@spec experimental_with_all_gpus(t()) :: t()

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.

@spec experimental_with_gpu(t(), [String.t()]) :: t()

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.

@spec from(t(), String.t()) :: t()

Initializes this container from a pulled base image.

@spec id(t()) :: {:ok, Dagger.ContainerID.t()} | {:error, term()}

A unique identifier for this Container.

@spec image_ref(t()) :: {:ok, String.t()} | {:error, term()}

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.

@spec label(t(), String.t()) :: {:ok, String.t() | nil} | {:error, term()}

Retrieves the value of the specified label.

@spec labels(t()) :: {:ok, [Dagger.Label.t()]} | {:error, term()}

Retrieves the list of labels passed to container.

@spec mounts(t()) :: {:ok, [String.t()]} | {:error, term()}

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.

@spec stderr(t()) :: {:ok, String.t()} | {:error, term()}

The error stream of the last executed command.

Will execute default command if none is set, or error if there's no default.

@spec stdout(t()) :: {:ok, String.t()} | {:error, term()}

The output stream of the last executed command.

Will execute default command if none is set, or error if there's no default.

@spec sync(t()) :: {:ok, t()} | {:error, term()}

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).

@spec user(t()) :: {:ok, String.t()} | {:error, term()}

Retrieves the user to be set for all commands.

@spec with_default_args(t(), [String.t()]) :: t()

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.

@spec with_entrypoint(t(), [String.t()], [{:keep_default_args, boolean() | nil}]) ::
  t()

Retrieves this container but with a different command entrypoint.

@spec with_env_variable(t(), String.t(), String.t(), [{:expand, boolean() | nil}]) ::
  t()

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.

@spec with_focus(t()) :: t()

Indicate that subsequent operations should be featured more prominently in the UI.

@spec with_label(t(), String.t(), String.t()) :: t()

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.

@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.

@spec with_mounted_temp(t(), String.t()) :: t()

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.

@spec with_user(t(), String.t()) :: t()

Retrieves this container with a different command user.

@spec with_workdir(t(), String.t()) :: t()

Retrieves this container with a different working directory.

@spec without_default_args(t()) :: t()

Retrieves this container with unset default arguments for future commands.

@spec without_directory(t(), String.t()) :: t()

Retrieves this container with the directory at the given path removed.

@spec without_entrypoint(t(), [{:keep_default_args, boolean() | nil}]) :: t()

Retrieves this container with an unset command entrypoint.

@spec without_env_variable(t(), String.t()) :: t()

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.

@spec without_file(t(), String.t()) :: t()

Retrieves this container with the file at the given path removed.

@spec without_focus(t()) :: t()

Indicate that subsequent operations should not be featured more prominently in the UI.

This is the initial state of all containers.

@spec without_label(t(), String.t()) :: t()

Retrieves this container minus the given environment label.

@spec without_mount(t(), String.t()) :: t()

Retrieves this container after unmounting everything at the given path.

@spec without_registry_auth(t(), String.t()) :: t()

Retrieves this container without the registry authentication of a given address.

@spec without_secret_variable(t(), String.t()) :: t()

Retrieves this container minus the given environment variable containing the secret.

@spec without_unix_socket(t(), String.t()) :: t()

Retrieves this container with a previously added Unix socket removed.

@spec without_user(t()) :: t()

Retrieves this container with an unset command user.

Should default to root.

@spec without_workdir(t()) :: t()

Retrieves this container with an unset working directory.

Should default to "/".

@spec workdir(t()) :: {:ok, String.t()} | {:error, term()}

Retrieves the working directory for all commands.