dockerfile
Configuration of a dockerfile resource built locally before being run.
The runtime performs a docker build in context, then starts the
resulting image as it would for a [crate::ContainerConfig].
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
build_args | map of string | no | Build-time ARG values passed to docker build --build-arg. | |
command | Command | no | Optional override for the image default CMD. The image ENTRYPOINT is preserved. See [Command] for the accepted forms and for what this means against an image whose entrypoint is a binary rather than a shell. | |
context | string | yes | Build context path, relative to the manifest file. Resolved to an absolute path by [crate::Manifest::resolve_host_volume_paths] before it is handed to the runtime. | |
depends_on | array of string | no | Names of other resources this build must wait for before starting. Validated by [crate::Manifest::validate]. | |
dockerfile | string | no | "Dockerfile" | Path to the Dockerfile within context. Defaults to "Dockerfile". |
entrypoint | Command | no | Optional override for the image ENTRYPOINT, the executable the container runs. See [Command] for the accepted forms. Setting this discards the image CMD: every target (the Engine API, Compose and Kubernetes) ignores the image default command once an entrypoint is overridden. Set command as well to supply arguments. An empty list or a blank string is rejected; omit the field to keep the image entrypoint. | |
env | map of string | no | Environment variables injected into the container at runtime. Values support ${env.NAME} and ${resources.name.property} interpolation. | |
healthcheck | Healthcheck | no | Optional healthcheck override. See [Healthcheck] for field semantics. | |
ports | array of PortMapping | no | Port mappings between the host and the container. See [PortMapping]. | |
secrets | map of string | no | Sensitive environment variables injected at runtime. Exporters preserve each key but replace its value with a placeholder, preventing credentials from being baked into generated artifacts. | |
target | string | no | Multi-stage build target passed to docker build --target. | |
volumes | array of string | no | Volume mappings in "host:container" or "named:container" form. Relative host paths are resolved by [crate::Manifest::resolve_host_volume_paths]. | |
working_dir | string | no | Optional working directory override inside the container. |