NAME

Dist::Zilla::Plugin::Docker::API - Build and publish Docker images as Dist::Zilla release artifacts

VERSION

version 0.002

SYNOPSIS

[Docker::API]
image = ghcr.io/example/my-app

build_tag = latest
build_tag = test-%v

release_tag = %v
release_tag = latest

dockerfile = Dockerfile
context = archive

build_load = 1
release_push = 1

Or via pluginbundle:

[@Author::GETTY]
docker_image = ghcr.io/example/my-app
docker_build = latest
docker_release = %v

DESCRIPTION

This plugin builds and publishes Docker images as release artifacts derived from the Dist::Zilla-built distribution.

BEHAVIOR

| Dzil command | Docker behavior | |---|---| | dzil build | Build image, apply build_tag, load into daemon (if build_load=1), no push | | dzil release | Build image from release artifact, apply release_tag, push (if release_push=1), load (if release_load=1) |

CONFIGURATION

image - Full image repository (required). Example: ghcr.io/user/my-app

build_tag - Tags applied during dzil build. Default: latest

release_tag - Tags applied and pushed during dzil release. Default: %v

dockerfile - Dockerfile name (default: Dockerfile)

context - Build context mode: build (default), source, or archive

build_load - Load built image into local Docker daemon (default: true)

release_push - Push to registry during release (default: true)

release_load - Load released image locally (default: false)

fail_if_tag_exists - Error if tag already exists on remote

skip_latest_on_trial - Skip 'latest' tag for trial releases

build_arg - Build arguments (can be repeated, template-enabled)

label - OCI labels (can be repeated, template-enabled)

BACKWARD COMPATIBILITY

The following deprecated names are still supported but may be removed in a future release:

repository - Use image instead

phase - No longer needed; behavior is implicit based on dzil command

tag - Use build_tag or release_tag instead

push - Use release_push instead

load - Use build_load instead

SEE ALSO

Dist::Zilla::Plugin::Docker::API::Config, Dist::Zilla::Plugin::Docker::API::TagTemplate, Dist::Zilla::Plugin::Docker::API::Context, Dist::Zilla::Plugin::Docker::API::Client, Dist::Zilla::Plugin::Docker::API::Result

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-dist-zilla-plugin-docker-api/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.