[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 #11766

vidyasagarnimmagaddi · 2025-03-10T11:43:42Z

Related to actions#11766 --- For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/actions/runner-images/issues/11766?shareId=XXXX-XXXX-XXXX-XXXX).

Nikfuad · 2025-03-27T14:12:57Z

The Hill.PDF

Dustin4444 · 2025-03-28T18:16:52Z

Breaking changes

Docker Engine Version 26.* will be removed from Ubuntu Os'es and Docker Engine Version 28* will added

Target date

Image deployment will start on 2025-05-05 and will take 2-3 days

The motivation for the changes

Updating the Docker Engine to Latest version i.e 28*, Customers will be able to use the latest version.

Possible impact

If your projects depend on Docker Engine version i.e 26.* they might be broken

Platforms affected

Azure DevOps[x] GitHub Actions

Runner images affected

Ubuntu 20.04[x] Ubuntu 22.04[x] Ubuntu 24.04[ ] macOS 13[ ] macOS 13 Arm64[ ] macOS 14[ ] macOS 14 Arm64[ ] macOS 15[ ] macOS 15 Arm64[ ] Windows Server 2019[ ] Windows Server 2022[ ] Windows Server 2025

Mitigation ways

Customers should be able to use the latest version Docker Engine i.e 28.* N/A

Fixes actions#11766 Update Docker Engine to Version 28.* in Ubuntu OS images. * **Update toolset files** - Update `images/ubuntu/toolsets/toolset-2004.json` to list Docker Engine Version 28.*, Docker CE CLI Version 28.*, and Docker Compose Version 2.28.0. - Update `images/ubuntu/toolsets/toolset-2204.json` to list Docker Engine Version 28.*, Docker CE CLI Version 28.*, and Docker Compose Version 2.28.0. - Update `images/ubuntu/toolsets/toolset-2404.json` to list Docker Engine Version 28.*, Docker CE CLI Version 28.*, and Docker Compose Version 2.28.0. * **Add tests for Docker Engine Version 28.*** - Add `images/ubuntu/scripts/tests/Docker.Tests.ps1` to include tests for Docker Engine Version 28.*. --- For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/actions/runner-images/issues/11766?shareId=XXXX-XXXX-XXXX-XXXX).

Dustin4444 · 2025-03-28T18:30:10Z

#11891

Dustin4444 · 2025-04-02T03:46:01Z

Breaking changes

Docker Engine Version 26.* will be removed from Ubuntu Os'es and Docker Engine Version 28* will added

Target date

Image deployment will start on 2025-05-05 and will take 2-3 days

The motivation for the changes

Updating the Docker Engine to Latest version i.e 28*, Customers will be able to use the latest version.

Possible impact

If your projects depend on Docker Engine version i.e 26.* they might be broken

Platforms affected

Azure DevOps[x] GitHub Actions

Runner images affected

Ubuntu 20.04[x] Ubuntu 22.04[x] Ubuntu 24.04[ ] macOS 13[ ] macOS 13 Arm64[ ] macOS 14[ ] macOS 14 Arm64[ ] macOS 15[ ] macOS 15 Arm64[ ] Windows Server 2019[ ] Windows Server 2022[ ] Windows Server 2025

Mitigation ways

Customers should be able to use the latest version Docker Engine i.e 28.* N/A

thompson-shaun · 2025-04-04T20:30:03Z

It's great to see the upgrade to Docker Engine v28 is in the works!

Unfortunately, it looks like there might be a short time period where the default actions-runner won't behave as expected.

Warning

This will impact users after April 15, 2025 (when cache v2 becomes the default), and before Docker Engine v28 is available by default in the GitHub-hosted runner images.

Working scenarios

Using the latest docker/setup-buildx-action with default settings
Using docker/setup-docker-action with default settings
Using

Breaking scenarios

If you’re only using docker/build-push-action without a setup step, you’re relying on the default Docker/Buildkit from the runner — which is not compatible with cache v2 during this window.
If you use setup-buildx-action but override the driver with driver: docker, you’ll also be using the system Buildkit — leading to the same breakage.

Recommended Workaround (Until Runner Images Are Updated)

Use the following setup to ensure your workflow uses a compatible Buildx + BuildKit combo:

  -
    name: Set up Docker Buildx
    uses: docker/setup-buildx-action@v3
    with:
      version: latest

This defaults to the docker-container driver with the latest versions of Buildx and BuildKit.

If you're using compose the setup-compose-action can be used to ensure that docker compose >= 2.33.1

  -
    name: Set up Docker Compose
    uses: docker/setup-compose-action@v1
    with:
      version: latest

Compatibility Table

Scenario	Cache v2 Support	Notes
`docker/setup-buildx-action` (default)	✅ Yes	Uses docker-container driver with recent Buildkit
`docker/setup-buildx-action` with `driver: docker`	❌ No	Uses runner's system Buildkit (v27 or older)
`docker/setup-docker-action`	✅ Yes	Installs Docker v28+ with compatible Buildkit
No setup action used	❌ No (starting April 15)	Breaks with cache v2 until updated runner images with Docker v28 lands

HinTak · 2025-04-05T00:11:39Z

I am experiencing a ci failure which seems to be a result of this, between ubuntu-22.04 changing from 20250323.1.0 to 20250330.1.0.

The full CI script is at:
https://github.com/kyamagu/skia-python/blob/de658a41204c3626103fc43ce63a37e4ea24f6f2/.github/workflows/ci.yml#L19

And I am using these three actions, basically:

uses: actions/cache@v4
uses: docker/setup-qemu-action@v3
uses: docker://quay.io/pypa/manylinux_2_28_aarch64:2024.07.02-0

The 0323 image finishes with at the post run actions/cache stage:

Post job cleanup.
/usr/bin/tar --posix -cf cache.tzst --exclude cache.tzst -P -C /home/runner/work/skia-python/skia-python --files-from manifest.txt --use-compress-program zstdmt
Sent 0 of 35[2](https://github.com/kyamagu/skia-python/actions/runs/14208007458/job/39809771074#step:13:2)614882 (0.0%), 0.0 MBs/sec
Sent 285506018 of 352614882 (81.0%), 136.1 MBs/sec
Sent 352614882 of 352614882 (100.0%), 162.5 MBs/sec
Cache saved with key: linux-aarch64-skia-0c1[3](https://github.com/kyamagu/skia-python/actions/runs/14208007458/job/39809771074#step:13:3)db4bc725ed731be05ab2f36b3fa1f0ee98a6-3rd-party

While the 0330 image fails to create the cache:

Post job cleanup.
/usr/bin/tar --posix -cf cache.tzst --exclude cache.tzst -P -C /home/runner/work/skia-python/skia-python --files-from manifest.txt --use-compress-program zstdmt
Failed to save: Unable to reserve cache with key linux-aarch64-skia-0de4[2](https://github.com/kyamagu/skia-python/actions/runs/14230690809/job/39931028919#step:13:2)3d1e4b286368db6106fcf58283f9caa8055-3rd-party, another job may be creating this cache.

Should I insert the buildx action in the middle or something? Or should I do something after the docker: action? I feel this is related but not sure what I should do - or should I just wait till April 15?

HinTak · 2025-04-06T11:07:01Z

Sorry for the noise.

Apparently the correct way to handle
"Failed to save: Unable to reserve cache with key ...., another job may be creating this cache." , is to wait for 24 hours (after the "reservation" expires), before re-run. No point in rerunning failed jobs within that period. It has gone through now.

@tag

## Description Note about sunset of GitHub Cache service v1 on April 15th, 2025. ## Related issues or tickets * https://gh.io/gha-cache-sunset * docker/build-push-action#1345 * docker/setup-buildx-action#414 * moby/buildkit#5896 * actions/runner-images#11766 (comment) ## Reviews   - [x] Technical review - [x] Editorial review - [ ] Product review Signed-off-by: CrazyMax <[email protected]>

crazy-max · 2025-04-14T15:03:48Z

Note about sunset of GHA cache service v1 added to our docs: https://docs.docker.com/build/ci/github-actions/cache/#github-cache

dejwsz · 2025-04-15T13:48:33Z

I think it's good because we had issues with docker engine version 26.x in gh runners during quarkus based images' builds due to problems with files' timestamps, I think this is fixed in docker engine 28.x what should help.

…unner-images#11766 (comment))

peteyno36 · 2025-04-22T13:50:50Z

Good update

vidyasagarnimmagaddi added the Announcement label Mar 10, 2025

vidyasagarnimmagaddi self-assigned this Mar 10, 2025

vidyasagarnimmagaddi added Area: Containers OS: Ubuntu labels Mar 10, 2025

vidyasagarnimmagaddi changed the title ~~[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 278* from 2025-05-09~~ [Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 Mar 10, 2025

Dustin4444 mentioned this issue Mar 19, 2025

Update Docker Engine to version 28.1.0 #11836

Closed

mathbunnyru mentioned this issue Mar 20, 2025

Test server listening on IPv4/IPv6 jupyter/docker-stacks#2255

Merged

4 tasks

runner-images-hetzner-cloud bot mentioned this issue Mar 21, 2025

Ubuntu 22.04 (20250321.1) Image Update dwydler/test1#44

Merged

Dustin4444 linked a pull request Mar 28, 2025 that will close this issue

Update Docker Engine to Version 28.* #11897

Open

HinTak mentioned this issue Apr 5, 2025

M136 public kyamagu/skia-python#313

Merged

crazy-max mentioned this issue Apr 9, 2025

build: note about sunset of gha cache v1 docker/docs#22395

Merged

3 tasks

dejwsz mentioned this issue Apr 15, 2025

Multi-stage docker builds fail --optimized validation keycloak/keycloak#38893

Closed

2 tasks

nikhil-ctds added a commit to datastax/starlight-for-kafka that referenced this issue Apr 17, 2025

Added Set up Docker Compose step to fix CI failure. Context(actions/r…

af53758

…unner-images#11766 (comment))

nikhil-ctds added a commit to datastax/starlight-for-kafka that referenced this issue Apr 17, 2025

Added Set up Docker Compose step to fix CI failure. Context(actions/r…

20f52fc

…unner-images#11766 (comment))

tex3d mentioned this issue Apr 18, 2025

Implementation of the CoopVec Inference and Training builtin intrinisics microsoft/DirectXShaderCompiler#7290

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 #11766

[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 #11766

vidyasagarnimmagaddi commented Mar 10, 2025

Nikfuad commented Mar 27, 2025

Dustin4444 commented Mar 28, 2025

Breaking changes

Target date

The motivation for the changes

Possible impact

Platforms affected

Runner images affected

Mitigation ways

Dustin4444 commented Mar 28, 2025

Dustin4444 commented Apr 2, 2025

Breaking changes

Target date

The motivation for the changes

Possible impact

Platforms affected

Runner images affected

Mitigation ways

thompson-shaun commented Apr 4, 2025 •

edited

Loading

HinTak commented Apr 5, 2025

HinTak commented Apr 6, 2025

crazy-max commented Apr 14, 2025

dejwsz commented Apr 15, 2025

peteyno36 commented Apr 22, 2025

[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 #11766

[Ubuntu] Breaking change : Docker Engine Version 26.* will be updated to Docker Engine Version 28* from 2025-05-09 #11766

Comments

vidyasagarnimmagaddi commented Mar 10, 2025

Breaking changes

Target date

The motivation for the changes

Possible impact

Platforms affected

Runner images affected

Mitigation ways

Nikfuad commented Mar 27, 2025

Dustin4444 commented Mar 28, 2025

Breaking changes

Target date

The motivation for the changes

Possible impact

Platforms affected

Runner images affected

Mitigation ways

Dustin4444 commented Mar 28, 2025

Dustin4444 commented Apr 2, 2025

Breaking changes

Target date

The motivation for the changes

Possible impact

Platforms affected

Runner images affected

Mitigation ways

thompson-shaun commented Apr 4, 2025 • edited Loading

Working scenarios

Breaking scenarios

Recommended Workaround (Until Runner Images Are Updated)

Compatibility Table

HinTak commented Apr 5, 2025

HinTak commented Apr 6, 2025

crazy-max commented Apr 14, 2025

dejwsz commented Apr 15, 2025

peteyno36 commented Apr 22, 2025

thompson-shaun commented Apr 4, 2025 •

edited

Loading