Drop deprecated architectures, build aarch64 on ARM runners by sairon · Pull Request #324 · home-assistant/docker-base

sairon · 2025-11-13T13:20:55Z

Do not build base images for deprecated architectures. This means removal of build for all armv7, armhf and i386 image variants. Since there is no Raspbian image for any of the supported architectures, these base images are removed completely.

To make builds faster, aarch64 images are now built on the arm runners.

Not to be merged before last 2025.11.x Core patch release, in case that we need to update the base image for a bug fix.

Do not build base images for deprecated architectures. This means removal of build for all armv7, armhf and i386 image variants. Since there is no Raspbian image for any of the supported architectures, these base images are removed completely.

…handling

As we're now effectively building only aarch64 or amd64, we can simply pass the arch to the builder image argument.

cdce8p

Thanks for preparing this one! Looking forward to dropping these.

Left a few suggestion below.

--
The new Github UI doesn't seem to handle suggestions quite right yet. Not sure they will all apply. Might be best to commit them manually.

cdce8p · 2025-11-13T14:11:49Z

  DEBIAN_LATEST: "trixie"
  UBUNTU_LATEST: "24.04"
-  RASPBIAN_LATEST: "trixie"
  PYTHON_LATEST: "3.13"


Suggested change

PYTHON_LATEST: "3.13"

PYTHON_LATEST: "3.14"

The default for Python should be updated to 3.14. It was deferred previously as 3.14 was only added from amd64 and aarch64.

Maybe let's do it as a separate PR, so it's more prominent in the changelog?

cdce8p · 2025-11-13T14:12:11Z

 | aarch64-base-python | Alpine | 3.12, 3.13, 3.14 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 | 3.13-alpine3.22 |
 | amd64-base-python | Alpine | 3.12, 3.13, 3.14 | 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 | 3.13-alpine3.22 |


Same as above.

cdce8p · 2025-11-13T14:15:18Z

    name: Build ${{ matrix.arch }} alpine ${{ matrix.version }} base image
    needs: init
-    runs-on: *runs-on-ubuntu
+    runs-on: &builder-runs-on ${{ matrix.arch == 'aarch64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}


Suggested change

runs-on: &builder-runs-on ${{ matrix.arch == 'aarch64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}

runs-on: ${{ matrix.os }}

I'd suggest to use matrix.include instead. This looks cleaner than the ternary expression here. Will leave a suggestion below.

IMHO it's a matter of personal preference, I find this more readable than wrapping my head around how the matrix looks like with overrides and additions in include - although with just two combinations it's not that much convoluted.

matrix.include is more durable. Add a comment if you need to explain the code what is the expected range of values.

sairon · 2025-11-20T13:10:30Z

@cdce8p Implemented your suggestions. I'll wait with the bump to Python 3.14 by default after this gets merged (which we can already do tomorrow), so we don't have to run the slow and unnecessary builds.

cdce8p · 2025-11-20T15:11:12Z

@cdce8p Implemented your suggestions. I'll wait with the bump to Python 3.14 by default after this gets merged (which we can already do tomorrow), so we don't have to run the slow and unnecessary builds.

Works for me! The changes here look good, can't wait until we finally drop these.

One side note, would you mind removing the @ mention for me in the squash merge commit message? It's often times pretty annoying to be notified just when some random forks rebases main and one commit contains my Github handle with @. AFAIK the Github team is working to fix that at some point, hopefully soon. As a general rule I usually tend to avoid '@' mentions in commit messages all together.

agners

LGTM!

After home-assistant/docker-base#324 there won't be base image builds for the deprecated architectures. Techically we could still build an image here for those architectures by using the last available tag (`*-2025.11.1`), but since there's currently no need for that, simply drop them.

sairon · 2025-11-21T17:03:23Z

Core 2025.11.3 is being shipped, so let's merge this!

home-assistant Bot added the cla-signed label Nov 13, 2025

sairon added 3 commits November 13, 2025 14:25

Drop build of deprecated architectures

970b0ba

Do not build base images for deprecated architectures. This means removal of build for all armv7, armhf and i386 image variants. Since there is no Raspbian image for any of the supported architectures, these base images are removed completely.

Remove deprecated architectures from Dockerfile comments and S6_ARCH …

6b4fd65

…handling

Use arm64 runners for aarch64 builds

3c59f55

As we're now effectively building only aarch64 or amd64, we can simply pass the arch to the builder image argument.

sairon force-pushed the drop-deprecated-archs branch from 7d1f6d8 to 3c59f55 Compare November 13, 2025 13:25

cdce8p reviewed Nov 13, 2025

View reviewed changes

sairon added 2 commits November 20, 2025 12:54

Remove unnecessary matrix excludes

10f9dcd

Use matrix include pattern to select builder as suggested by @cdce8p

4a072ca

sairon requested a review from cdce8p November 20, 2025 13:07

cdce8p approved these changes Nov 20, 2025

View reviewed changes

cdce8p mentioned this pull request Nov 20, 2025

Add release-suffixed tags to Docker images for version pinning #326

Merged

sairon marked this pull request as ready for review November 21, 2025 15:09

agners approved these changes Nov 21, 2025

View reviewed changes

Merge branch 'master' into drop-deprecated-archs

7870406

sairon mentioned this pull request Nov 21, 2025

Drop deprecated architectures home-assistant/docker#371

Merged

sairon merged commit 57fa69e into master Nov 21, 2025
40 checks passed

sairon deleted the drop-deprecated-archs branch November 21, 2025 17:03

		\| aarch64-base-python \| Alpine \| 3.12, 3.13, 3.14 \| 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 \| 3.13-alpine3.22 \|
		\| amd64-base-python \| Alpine \| 3.12, 3.13, 3.14 \| 3.12-alpine3.20, 3.12-alpine3.21, 3.12-alpine3.22, 3.13-alpine3.20, 3.13-alpine3.21, 3.13-alpine3.22, 3.14-alpine3.20, 3.14-alpine3.21, 3.14-alpine3.22 \| 3.13-alpine3.22 \|

	runs-on: &builder-runs-on ${{ matrix.arch == 'aarch64' && 'ubuntu-24.04-arm' \|\| 'ubuntu-24.04' }}
	runs-on: ${{ matrix.os }}

Conversation

sairon commented Nov 13, 2025

Uh oh!

cdce8p left a comment • 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!

cdce8p Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

sairon Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

cdce8p Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

sairon Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

cdce8p Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

sairon Nov 13, 2025

Choose a reason for hiding this comment

Uh oh!

eshattow Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sairon commented Nov 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cdce8p commented Nov 20, 2025

Uh oh!

agners left a comment

Choose a reason for hiding this comment

Uh oh!

sairon commented Nov 21, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

cdce8p left a comment •

edited

Loading

sairon commented Nov 20, 2025 •

edited

Loading