Struct DockerV2Config 

pub struct DockerV2Config {

    pub id: Option<String>,
    pub ids: Option<Vec<String>>,
    pub dockerfile: String,
    pub images: Vec<String>,
    pub tags: Vec<String>,
    pub labels: Option<HashMap<String, String>>,
    pub annotations: Option<HashMap<String, String>>,
    pub extra_files: Option<Vec<String>>,
    pub platforms: Option<Vec<String>>,
    pub build_args: Option<HashMap<String, String>>,
    pub retry: Option<DockerRetryConfig>,
    pub flags: Option<Vec<String>>,
    pub skip: Option<StringOrBool>,
    pub sbom: Option<StringOrBool>,
    pub hooks: Option<BuildHooksConfig>,
}

Docker V2 configuration — the canonical Docker build API.

Notable surface:

• images + tags (cleaner separation than a single image_templates list)
• annotations map for OCI annotations (--annotation)
• build_args map for build-time variables
• skip as a StringOrBool template for conditional opt-out
• sbom as a StringOrBool — when truthy, adds --sbom=true to buildx
• flags for arbitrary extra docker build flags
• platforms is the only target selector — no per-arch field overrides

Fields

id: Option<String>

Unique identifier for this Docker V2 config.

ids: Option<Vec<String>>

Build IDs filter: only include binary artifacts whose metadata id is in this list.

dockerfile: String

Path to the Dockerfile relative to the project root.

images: Vec<String>

Base image names (e.g., [“ghcr.io/owner/app”]). Combined with tags to form full references.

tags: Vec<String>

Tag suffixes (e.g., [“latest”, “{{ .Version }}”]). Each image is tagged with each tag.

labels: Option<HashMap<String, String>>

OCI labels to apply to the image via --label key=value flags.

annotations: Option<HashMap<String, String>>

OCI annotations to apply via --annotation key=value flags.

extra_files: Option<Vec<String>>

Extra files to copy into the Docker build context.

platforms: Option<Vec<String>>

Target platforms for multi-arch builds (e.g., [“linux/amd64”, “linux/arm64”]).

build_args: Option<HashMap<String, String>>

Build arguments passed as --build-arg KEY=VALUE.

Each value is template-expanded and forwarded verbatim to buildx (one argv token per pair, no shell tokenization). Prefer {{ .Env.VAR }} over raw user-config strings for secrets — buildx records build-args in image history by default, so plaintext values here propagate into the image metadata.

retry: Option<DockerRetryConfig>

Retry configuration for docker push operations.

flags: Option<Vec<String>>

Arbitrary extra flags passed to the docker build command.

skip: Option<StringOrBool>

When truthy, skip this docker build entirely. Supports templates. Accepts the legacy disable: spelling via serde alias for back-compat with imported GoReleaser configs (GR’s docker config field is pkg/config/config.go:1149 Disable string).

sbom: Option<StringOrBool>

When truthy, adds --sbom=true to buildx. Supports templates.

hooks: Option<BuildHooksConfig>

Pre/post hooks for this docker_v2 config. Each hook accepts the same cmd/dir/env/output shape as build/archive hooks. pre hooks run after the staging directory is prepared but before docker buildx build; post hooks run after the image digest is captured. Hook commands, working directories, and env values are template-expanded; in addition to the standard template surface, hooks see:

• {{ .Images }} — list of image:tag references for this build. Iterate via {% for img in Images %}{{ img }}{% endfor %} to mirror GR’s []string exposure of the same field; {{ .Images | join(sep=",") }} reproduces a flat comma-separated string for legacy templates.
• {{ .Dockerfile }} — path to the rendered Dockerfile
• {{ .ContextDir }} — path to the buildx context staging directory
• {{ .Digest }} — image manifest digest (post hooks only)
• {{ .BaseImage }} / {{ .BaseImageDigest }} — final-stage base image (matches the BaseImage / BaseImageDigest overlay GR adds in internal/pipe/docker/v2/docker.go)

Trait Implementations

impl Clone for DockerV2Config

fn clone(&self) -> DockerV2Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DockerV2Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DockerV2Config

fn default() -> DockerV2Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DockerV2Config

where DockerV2Config: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for DockerV2Config

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for DockerV2Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.