feat(docker/v2): initial implementation #5793

caarlos0 · 2025-05-26T19:05:44Z

This is the v2 of the docker feature!

better DX (less yaml repetition and templates)
simpler implementation

So now, what happens:

if --snapshot, it'll build the manifest, but not push it (only useful to test the actual docker image build, not the image itself)
otherwise, on publish, it'll run a single docker buildx build to build and publish the manifest + SBOM
docker_signs should still work
docker_digests should still work

Discussion for after the merge: https://github.com/orgs/goreleaser/discussions/6005

TODO from the top of my head:

closes #5733

Not really needed, will only run in publish, which runs in the merging step. ↩

cloudflare-workers-and-pages · 2025-05-27T00:17:37Z

Deploying goreleaser with Cloudflare Pages

Latest commit:	`ddae597`
Status:	✅ Deploy successful!
Preview URL:	https://4faac312.goreleaser.pages.dev
Branch Preview URL:	https://docker-v2.goreleaser.pages.dev

View logs

codecov · 2025-05-27T00:37:15Z

Codecov Report

❌ Patch coverage is 81.34111% with 64 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (main@c5158b4). Learn more about missing BASE report.
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
internal/pipe/docker/v2/docker.go	77.85%	50 Missing and 14 partials ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #5793   +/-   ##
=======================================
  Coverage        ?   82.75%           
=======================================
  Files           ?      167           
  Lines           ?    16932           
  Branches        ?        0           
=======================================
  Hits            ?    14012           
  Misses          ?     2314           
  Partials        ?      606

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

.goreleaser.yaml

jkroepke · 2025-08-21T06:02:33Z

pkg/config/config.go

@@ -1054,6 +1056,20 @@ type DockerManifest struct {
 	Retry          Retry    `yaml:"retry,omitempty" json:"retry,omitempty"`
 }

+// DockerV2 is the new Docker build pipe options.
+type DockerV2 struct {


Any reason for not exposing build_flag_templates ?

Use-cases are --build-context, --cache-from, --cache-to, --no-cache.

Not sure if it worth to expose each single CLI options. Something like extra_args for advanced usage would be great.

yeah I think we can add the flags yes

will probably do in a subsequent PR

jkroepke · 2025-08-21T06:06:54Z

www/docs/customization/dockers_v2.md

+
+## Setting up a builder
+
+For buildx to work, you'll need to have a builder that supports multi-platform


Note sure, if you would like to mention

https://github.com/docker/setup-buildx-action

for GHA as well.

good catch! We should probably have a complete actions example

www/docs/customization/dockers_v2.md

jkroepke · 2025-08-21T06:18:48Z

www/docs/deprecations.md

+Feel free to suggest improvements
+[here](https://github.com/orgs/goreleaser/discussions/6005).


What about having a push option, which has the value push: {{ not .IsSnapshot }} by default. If an end-user really wants to have usage images from a snapshot build, he can opt-in. He also can use templated image_templates to configure different push location.

My use case here: I'm running --snapshot on main branches and I would like to push the main branch to the main tag. Thats one way, how I can quickly get feedback from reporters without publish a full release.

That's the use case for nightly builds... if we allow to pass random flags, though, you could still pass a {{ if .IsSnapshot }}--push{{ end }} then 🤔

jkroepke · 2025-08-21T06:20:10Z

www/docs/customization/dockers_v2.md

+
+The build context itself is a temporary directory which contains the binaries
+and packages for the target platforms, which you can `COPY` into your image
+(mind the use of `$TARGETPLATFORM` above).


Great Idea!

needs #5793 Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

ryancurrah · 2025-08-22T12:55:55Z

we will now run a single docker buildx build with the given platforms, which will build and publish the manifest and SBOM.

For teams that only use Go Releaser to build artifacts (and not to publish them), will this switch to docker buildx build + manifest publishing break our workflow?

This is how we currently build artifacts.

goreleaser release --clean --skip=validate,publish

caarlos0 · 2025-08-22T15:26:03Z

Hmmm this might need some extra work - can you open an issue for this particular case?

If you run with --snapshot it will create the local images btw, but with skip publish it won't

feat(docker): dockers_v2

ce3a9fc

caarlos0 self-assigned this May 26, 2025

pull-request-size bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 26, 2025

wip

3dd8e5c

pull-request-size bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels May 27, 2025

test: fix

d7bacc1

caarlos0 mentioned this pull request May 27, 2025

New dockers configuration section #5733

Closed

This comment was marked as outdated.

Sign in to view

caarlos0 added 2 commits June 7, 2025 11:34

Merge remote-tracking branch 'origin/main' into docker-v2

94ed20d

wip

dab336c

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

This comment was marked as outdated.

Sign in to view

caarlos0 marked this pull request as draft July 25, 2025 02:02

This comment was marked as outdated.

Sign in to view

caarlos0 added 4 commits August 18, 2025 22:23

Merge remote-tracking branch 'origin/main' into docker-v2

e045203

wip

65af30e

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

wip

13e72ea

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

wip

c0e4552

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

caarlos0 added 12 commits August 20, 2025 21:28

Merge remote-tracking branch 'origin/main' into docker-v2

d388dd7

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

test: fix conflicting test

e5e56c8

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

fix: digest

0ff3655

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

test: improvements

de78592

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

fix: cleanup

57d2e36

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

ci: network host

3984aad

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

chore: cleanups

c7c0ff6

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

wip

38e2932

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

docs

cd3365d

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

test

664bcaa

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

docs

a2d2a85

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

ctx

37ad05d

Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

jkroepke reviewed Aug 21, 2025

View reviewed changes

.goreleaser.yaml Show resolved Hide resolved

jkroepke reviewed Aug 21, 2025

View reviewed changes

www/docs/customization/dockers_v2.md Show resolved Hide resolved

jkroepke reviewed Aug 21, 2025

View reviewed changes

Merge remote-tracking branch 'origin/main' into docker-v2

ddae597

caarlos0 mentioned this pull request Aug 21, 2025

feat(docker/v2): support annotations #6011

Merged

caarlos0 changed the title ~~feat(docker): dockers_v2~~ feat(docker/v2): initial implementation Aug 21, 2025

caarlos0 added a commit that referenced this pull request Aug 21, 2025

feat(docker/v2): support arbitrary flags

3bd6ae0

needs #5793 Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

caarlos0 mentioned this pull request Aug 21, 2025

feat(docker/v2): support arbitrary flags #6012

Merged

caarlos0 merged commit 102762f into main Aug 21, 2025
17 of 18 checks passed

caarlos0 deleted the docker-v2 branch August 21, 2025 20:28

caarlos0 added a commit that referenced this pull request Aug 21, 2025

feat(docker/v2): support arbitrary flags

2311d59

needs #5793 Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

caarlos0 added a commit that referenced this pull request Aug 22, 2025

feat(docker/v2): support arbitrary flags (#6012)

72a00ef

needs #5793 Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>

caarlos0 added a commit that referenced this pull request Aug 22, 2025

feat(docker/v2): support annotations (#6011)

d7b45d1

needs #5793 Signed-off-by: Carlos Alexandro Becker <caarlos0@users.noreply.github.com>


		## Setting up a builder

		For buildx to work, you'll need to have a builder that supports multi-platform

		Feel free to suggest improvements
		[here](https://github.com/orgs/goreleaser/discussions/6005).

Uh oh!

feat(docker/v2): initial implementation #5793

feat(docker/v2): initial implementation #5793

Conversation

caarlos0 commented May 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

So now, what happens:

TODO from the top of my head:

Footnotes

Uh oh!

cloudflare-workers-and-pages bot commented May 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying goreleaser with Cloudflare Pages

Uh oh!

codecov bot commented May 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

Uh oh!

jkroepke Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

caarlos0 Aug 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jkroepke Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

caarlos0 Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jkroepke Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

caarlos0 Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

jkroepke Aug 21, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ryancurrah commented Aug 22, 2025

Uh oh!

caarlos0 commented Aug 22, 2025

Uh oh!

Uh oh!

caarlos0 commented May 26, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented May 27, 2025 •

edited

Loading

codecov bot commented May 27, 2025 •

edited

Loading

caarlos0 Aug 21, 2025 •

edited

Loading