[Enhancement/Bug*]: Testcontainers does not fall back to linux/amd64 when registry returns missing architecture
メンテナーはふだん 1 日以内に返信
@anushkasrvstv がすでに取り組んでいます。
2026年6月4日 から。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 45/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- docker, java
- 領域
- devops, testing-qa
調査の方向性
まず issue 9214 と pull request 9200 を読み、次に DockerClientException と NotFoundException に対する既存の fallback 処理を特定します。説明されている registry の動作に対して arm64 イメージの pull 失敗を再現し、関連するテストを調べます。アーキテクチャが見つからない場合のレスポンスが一貫して処理されるか、要求されたアーキテクチャ/fallback オプションが明確にサポートされれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Module
Core
Testcontainers version
1.21.4
Using the latest Testcontainers version?
Yes
Host OS
Mac
Host Arch
arm64
Docker version
podman version
Client: Podman Engine
Version: 5.6.2
API Version: 5.6.2
Go Version: go1.25.1
Git Commit: 9dd5e1ed33830612bc200d7a13db00af6ab865a4
Built: Tue Sep 30 21:35:47 2025
Build Origin: pkginstaller
OS/Arch: darwin/arm64
Server: Podman Engine
Version: 5.6.2
API Version: 5.6.2
Go Version: go1.24.7
Git Commit: 9dd5e1ed33830612bc200d7a13db00af6ab865a4
Built: Tue Sep 30 02:00:00 2025
OS/Arch: linux/arm64
What happened?
Expected behavior
When pulling a Docker image that only provides a linux/amd64 platform, Testcontainers should automatically fall back to linux/amd64 on ARM-based hosts (e.g. Apple Silicon Macs), as it already does for DockerClientException and NotFoundException.
Actual behavior
Registries like JFrog Artifactory may return:
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
While the 500 Internal server error from JFrog is arguably misleading/incorrect I still think testcontainers should provide an option to specify the arch or fallback strategy outside of using a direct image SHA.
Relevant log output
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
at org.testcontainers.shaded.com.github.dockerjava.core.DefaultInvocationBuilder.execute(DefaultInvocationBuilder.java:247)
at org.testcontainers.shaded.com.github.dockerjava.core.DefaultInvocationBuilder.lambda$executeAndStream$1(DefaultInvocationBuilder.java:269)
at java.base/java.lang.Thread.run(Thread.java:1474)
2026-05-27T12:16:09.667+02:00 WARN 46613 --- [ Test worker] [] t.r.b.d.4.0.11-r2 : Retrying pull for image: registry.bankdata.dev/all-docker-centrals/ibm-messaging/mq:9.4.0.11-r2 (112s remaining)
2026-05-27T12:16:13.150+02:00 ERROR 46613 --- [ream--322867326] [] c.g.d.api.async.ResultCallbackTemplate : Error during callback
com.github.dockerjava.api.exception.InternalServerErrorException: Status 500: {"message":"no image found in manifest list for architecture \"arm64\", variant \"v8\", OS \"linux\""}
Additional Information
Issue has great similarity to:
issues/9214:pull/9200
but I am unsure if it qualifies as a bug or an enhancement.
Would love to get some input. Won't fix is a very valid response as the issue is primarily JFrog related.
- 主要言語
- Java
- スター
- 8.8k
- フォーク
- 2k
- 平均マージ
- 5日 21時間
- マージ済み PR(30日)
- 15
環境構築
このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
testcontainers/testcontainers-java のほかの issue
-
[Bug]: withStartupTimeout() changes the startup timeout of all containers that use the default wait strategy対応中かも @aymenjamaaoui が 1 日前に担当しました。 オープンtype/bug
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
testcontainers/testcontainers-java#12171 ·
メンテナーはふだん 1 日以内に返信
-
[Enhancement]: Document why singleton containers are required under Spring's test context caching対応中かも @zakaullah075 が 95 日前に担当しました。 オープンtype/enhancement
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
testcontainers/testcontainers-java#11967 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
[Bug]: Cannot reuse Selenium BrowserWebDriverContainers under Linux対応中かも @kdelay が 116 日前に担当しました。 オープンtype/bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
testcontainers/testcontainers-java#11941 ·
メンテナーはふだん 1 日以内に返信
-
[Bug]: DockerDesktopClientProviderStrategy is always applicable対応中かも @seonwooj0810 が 165 日前に担当しました。 オープンtype/bug
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
testcontainers/testcontainers-java#11829 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
[Enhancement]: cleanup document after removing junit4 support対応中かも @SJvaca30 が 173 日前に担当しました。 オープンtype/enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
testcontainers/testcontainers-java#11578 ·
メンテナーはふだん 1 日以内に返信
testcontainers/testcontainers-java の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 68/100
pact-foundation/pact-plugins#125 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
opencollab/flexdock#28 · コメント 1 件 ·
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
yegor256/jping#122 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
SAP/ai-sdk-java#1206 ·
メンテナーはふだん 1 日以内に返信
-
enhancement good first issue insight-module
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
sdlc-pro/spring-lens#606 ·
メンテナーはふだん 1 日以内に返信